$ agents diagnostics
- ╭─ Checks ────────────────────────────────────────────╮
- │ Check Status Details │
- │ ─────────────── ─────── ──────────────────── │
- │ Config file OK readable │
- │ Database ERROR locked by another process │
- │ OPENAI_API_KEY OK configured │
- │ Anthropic key ERROR invalid key format │
- │ Disk space WARN 312 MB free (low) │
- │ Text index OK tantivy 0.22 │
- │ Vector index ERROR FAISS library not found │
- │ Graph store OK neo4j 5.15 │
- │ File permissions OK data dir r/w │
- │ Git OK git 2.43.0 │
- ╰─────────────────────────────────────────────────────╯
+ ╭─ Checks ──────────────────────────────────────────────────╮
+ │ Check Status Details │
+ │ ─────────────────────────── ─────── ───────────────────────────── │
+ │ Config file OK readable │
+ │ Database ERROR locked by another process │
+ │ OpenAI key ERROR invalid key format │
+ │ Anthropic key OK configured │
+ │ Google key WARN missing │
+ │ Gemini key WARN missing │
+ │ Azure OpenAI key WARN missing │
+ │ OpenRouter key WARN missing │
+ │ Cohere key WARN missing │
+ │ Groq key WARN missing │
+ │ Together key WARN missing │
+ │ Disk space WARN 312 MB free (low) │
+ │ Text index OK tantivy 0.22 │
+ │ Vector index ERROR FAISS library not found │
+ │ Graph store OK neo4j 5.15 │
+ │ File permissions OK data dir r/w │
+ │ Git OK git 2.43.0 │
+ ╰───────────────────────────────────────────────────────────╯
╭─ Summary ─────────╮
- │ Checks: 10 total │
- │ Warnings: 1 │
+ │ Checks: 17 total │
+ │ Warnings: 8 │
│ Errors: 3 │
│ Duration: 1.2s │
╰───────────────────╯
@@ -1059,8 +1132,8 @@ When critical checks fail, diagnostics reports errors:
╭─ Errors (must fix) ─────────────────────────────────────────────────╮
│ 1. Database is locked by PID 12847 — stop the other process or │
│ delete the lock file at ~/.cleveragents/agents.db-lock │
- │ 2. Anthropic key starts with "pk-" — expected "sk-ant-" prefix │
- │ Run: agents config set provider.anthropic.api-key │
+ │ 2. OpenAI key starts with "pk-" — expected "sk-" prefix │
+ │ Run: agents config set provider.openai.api-key │
│ 3. FAISS library not installed — vector search will not work │
│ Run: pip install faiss-cpu │
╰─────────────────────────────────────────────────────────────────────╯
@@ -1074,30 +1147,37 @@ When critical checks fail, diagnostics reports errors:
$ agents diagnostics
Checks
- Check Status Details
- --------------- ------- ------------------------
- Config file OK readable
- Database ERROR locked by another process
- OPENAI_API_KEY OK configured
- Anthropic key ERROR invalid key format
- Disk space WARN 312 MB free (low)
- Text index OK tantivy 0.22
- Vector index ERROR FAISS library not found
- Graph store OK neo4j 5.15
- File permissions OK data dir r/w
- Git OK git 2.43.0
+ Check Status Details
+ ------------------------ ------- --------------------------
+ Config file OK readable
+ Database ERROR locked by another process
+ OpenAI key ERROR invalid key format
+ Anthropic key OK configured
+ Google key WARN missing
+ Gemini key WARN missing
+ Azure OpenAI key WARN missing
+ OpenRouter key WARN missing
+ Cohere key WARN missing
+ Groq key WARN missing
+ Together key WARN missing
+ Disk space WARN 312 MB free (low)
+ Text index OK tantivy 0.22
+ Vector index ERROR FAISS library not found
+ Graph store OK neo4j 5.15
+ File permissions OK data dir r/w
+ Git OK git 2.43.0
Summary
- Checks: 10 total
- Warnings: 1
+ Checks: 17 total
+ Warnings: 8
Errors: 3
Duration: 1.2s
Errors (must fix)
1. Database is locked by PID 12847 -- stop the other process or
delete the lock file at ~/.cleveragents/agents.db-lock
- 2. Anthropic key starts with "pk-" -- expected "sk-ant-" prefix
- Run: agents config set provider.anthropic.api-key
+ 2. OpenAI key starts with "pk-" -- expected "sk-" prefix
+ Run: agents config set provider.openai.api-key
3. FAISS library not installed -- vector search will not work
Run: pip install faiss-cpu
@@ -1115,8 +1195,15 @@ When critical checks fail, diagnostics reports errors:
"checks": [
{ "check": "Config file", "status": "ok", "details": "readable" },
{ "check": "Database", "status": "error", "details": "locked by another process" },
- { "check": "OPENAI_API_KEY", "status": "ok", "details": "configured" },
- { "check": "Anthropic key", "status": "error", "details": "invalid key format" },
+ { "check": "OpenAI key", "status": "error", "details": "invalid key format" },
+ { "check": "Anthropic key", "status": "ok", "details": "configured" },
+ { "check": "Google key", "status": "warn", "details": "missing" },
+ { "check": "Gemini key", "status": "warn", "details": "missing" },
+ { "check": "Azure OpenAI key", "status": "warn", "details": "missing" },
+ { "check": "OpenRouter key", "status": "warn", "details": "missing" },
+ { "check": "Cohere key", "status": "warn", "details": "missing" },
+ { "check": "Groq key", "status": "warn", "details": "missing" },
+ { "check": "Together key", "status": "warn", "details": "missing" },
{ "check": "Disk space", "status": "warn", "details": "312 MB free (low)" },
{ "check": "Text index", "status": "ok", "details": "tantivy 0.22" },
{ "check": "Vector index", "status": "error", "details": "FAISS library not found" },
@@ -1125,8 +1212,8 @@ When critical checks fail, diagnostics reports errors:
{ "check": "Git", "status": "ok", "details": "git 2.43.0" }
],
"summary": {
- "total": 10,
- "warnings": 1,
+ "total": 17,
+ "warnings": 8,
"errors": 3,
"duration_s": 1.2
},
@@ -1137,8 +1224,8 @@ When critical checks fail, diagnostics reports errors:
},
{
"index": 2,
- "message": "Anthropic key starts with \"pk-\" -- expected \"sk-ant-\" prefix",
- "fix": "agents config set provider.anthropic.api-key "
+ "message": "OpenAI key starts with \"pk-\" -- expected \"sk-\" prefix",
+ "fix": "agents config set provider.openai.api-key "
},
{
"index": 3,
@@ -1170,12 +1257,33 @@ When critical checks fail, diagnostics reports errors:
- check: Database
status: error
details: locked by another process
- - check: OPENAI_API_KEY
- status: ok
- details: configured
- - check: Anthropic key
+ - check: OpenAI key
status: error
details: invalid key format
+ - check: Anthropic key
+ status: ok
+ details: configured
+ - check: Google key
+ status: warn
+ details: missing
+ - check: Gemini key
+ status: warn
+ details: missing
+ - check: Azure OpenAI key
+ status: warn
+ details: missing
+ - check: OpenRouter key
+ status: warn
+ details: missing
+ - check: Cohere key
+ status: warn
+ details: missing
+ - check: Groq key
+ status: warn
+ details: missing
+ - check: Together key
+ status: warn
+ details: missing
- check: Disk space
status: warn
details: 312 MB free (low)
@@ -1195,8 +1303,8 @@ When critical checks fail, diagnostics reports errors:
status: ok
details: git 2.43.0
summary:
- total: 10
- warnings: 1
+ total: 17
+ warnings: 8
errors: 3
duration_s: 1.2
errors:
@@ -1205,10 +1313,12 @@ When critical checks fail, diagnostics reports errors:
Database is locked by PID 12847 -- stop the other process or
delete the lock file at ~/.cleveragents/agents.db-lock
- index: 2
- message: Anthropic key starts with "pk-" -- expected "sk-ant-" prefix
- fix: agents config set provider.anthropic.api-key
+ message: >-
+ OpenAI key starts with "pk-" -- expected "sk-" prefix
+ fix: agents config set provider.openai.api-key
- index: 3
- message: FAISS library not installed -- vector search will not work
+ message: >-
+ FAISS library not installed -- vector search will not work
fix: pip install faiss-cpu
timing:
duration_ms: 1200
diff --git a/src/cleveragents/cli/commands/system.py b/src/cleveragents/cli/commands/system.py
index b1416adf1..42bba1fe5 100644
--- a/src/cleveragents/cli/commands/system.py
+++ b/src/cleveragents/cli/commands/system.py
@@ -253,26 +253,26 @@ def _check_providers() -> list[dict[str, Any]]:
results: list[dict[str, Any]] = []
provider_checks = [
- ("openai", "OPENAI_API_KEY"),
- ("anthropic", "ANTHROPIC_API_KEY"),
- ("google", "GOOGLE_API_KEY"),
- ("azure", "AZURE_OPENAI_API_KEY"),
- ("openrouter", "OPENROUTER_API_KEY"),
- ("gemini", "GEMINI_API_KEY"),
- ("cohere", "COHERE_API_KEY"),
- ("groq", "GROQ_API_KEY"),
- ("together", "TOGETHER_API_KEY"),
+ ("openai", "OpenAI", "OPENAI_API_KEY"),
+ ("anthropic", "Anthropic", "ANTHROPIC_API_KEY"),
+ ("google", "Google", "GOOGLE_API_KEY"),
+ ("gemini", "Gemini", "GEMINI_API_KEY"),
+ ("azure", "Azure OpenAI", "AZURE_OPENAI_API_KEY"),
+ ("openrouter", "OpenRouter", "OPENROUTER_API_KEY"),
+ ("cohere", "Cohere", "COHERE_API_KEY"),
+ ("groq", "Groq", "GROQ_API_KEY"),
+ ("together", "Together", "TOGETHER_API_KEY"),
]
- for provider_name, env_var in provider_checks:
- configured = settings.has_provider_configured(provider_name)
+ for provider_slug, display_name, env_var in provider_checks:
+ configured = settings.has_provider_configured(provider_slug)
results.append(
{
- "name": f"{provider_name.capitalize()} key",
+ "name": f"{display_name} key",
"status": CheckStatus.OK if configured else CheckStatus.WARN,
"details": "configured" if configured else "missing",
"recommendation": (
- f"Set {env_var} to enable {provider_name.capitalize()} models"
+ f"Set {env_var} to enable {display_name} models"
if not configured
else None
),