shenxingy Clade — Status
Check the progress of autonomous coding loops running on a remote machine.
When to use
User asks about:
- Loop progress, iteration count, convergence status
- What the AI is working on
- How much it costs / has cost
- Recent commits
- Whether there are blockers
API
Endpoint: GET {CLADE_BASE_URL}/status
Optional query: ?project=/path/to/project (omit to use default)
Headers:
Authorization: Bearer {CLADE_API_KEY}
Response:
{
"project": "/home/user/myproject",
"loop": {
"iteration": 3,
"converged": false,
"goal": "/home/user/myproject/goals/fix-tests.md",
"started": "2025-03-24T14:30:45+0000"
},
"session": {
"mode": "run",
"status": "running",
"outer_iter": 2,
"feature": "auth-middleware"
},
"cost": {"total": "2.14", "last_iter": "0.43"},
"recent_commits": [
"abc1234 feat: add auth middleware",
"def5678 fix: login redirect bug",
"ghi9012 test: add auth integration tests"
],
"last_supervisor": "Planning 2 tasks: fix login test, update schema...",
"has_blockers": false
}
How to format the response
Format as a compact, phone-friendly message:
{converged ? "✅" : "🔄"} Loop: iter {iteration}/{max_iter if known, else "?"} ({converged ? "CONVERGED" : status})
📋 Goal: {goal filename, not full path}
🏷️ Feature: {feature}
💰 Cost: ${total} (last iter: ${last_iter})
Recent commits:
{each commit on its own line, indented}
{if has_blockers: "⚠️ BLOCKERS detected — run clade-report for details"}
{if last_supervisor not empty: "🧠 Supervisor: \"{first 100 chars}...\""}
Error handling
- Connection refused: "Monitor is not running. Start it with:
python monitor.py -p /project" - 401 Unauthorized: "Check your CLADE_API_KEY — it doesn't match the monitor's key."
- 404 project not found: "Project path not recognized. Check the --project flag on monitor.py."