shenxingy/clade-report

Clade — Report

Get detailed session reports, cost breakdowns, blockers, and skipped tasks.

When to use

User asks about:

• Session summary / what was accomplished
• Cost breakdown per iteration
• What tasks were skipped and why
• What blockers exist
• "What happened overnight" / "今天干了什么"

API

Endpoint: GET {CLADE_BASE_URL}/report

Optional query: ?project=/path/to/project

Headers:

Authorization: Bearer {CLADE_API_KEY}

Response:

{
  "project": "/home/user/myproject",
  "report": "## Session: 2025-03-24 14:30 → 22:15 (465min)\n\n### Status: converged\n\n### Completed\n12 commits since session start.\n\n### Skipped (2 tasks)\n## Skipped: flaky integration test\nReason: External API timeout\n\n### Blockers (0)\nNone\n\n### Cost: $8.42\n\n### Iterations: 5\n\n### Feature: auth-middleware",
  "cost_history": [
    {"ITER": "1", "COST": "1.50", "CUMULATIVE": "1.50", "TASKS": "3", "DURATION": "8min"},
    {"ITER": "2", "COST": "2.10", "CUMULATIVE": "3.60", "TASKS": "4", "DURATION": "12min"},
    {"ITER": "3", "COST": "1.80", "CUMULATIVE": "5.40", "TASKS": "2", "DURATION": "6min"}
  ],
  "blockers": "",
  "skipped": "## [2025-03-24T18:30:00+0000] Skipped: flaky integration test\nReason: External API timeout during test run\nAttempted: Retry 3 times, all timed out"
}

How to format the response

Full report:

📊 Session Report — {project name}
⏱️ {start time} → {end time} ({duration})
✅ Status: {status}

📈 Progress: {completed_count} commits in {iterations} iterations
💰 Total cost: ${cost}

{if cost_history:}
Cost per iteration:
  Iter 1: ${cost} ({tasks} tasks, {duration})
  Iter 2: ${cost} ({tasks} tasks, {duration})
  ...

{if skipped not empty:}
⏭️ Skipped tasks:
{skipped content, summarized to 2-3 lines max}

{if blockers not empty:}
⚠️ Blockers:
{blockers content, summarized to 2-3 lines max}

Quick cost summary (when user just asks "how much"):

💰 Total: ${cumulative from last cost_history entry}
Last iteration: ${cost} for {tasks} tasks in {duration}

Error handling

• Connection refused: "Monitor is not running."
• 401 Unauthorized: "Check your CLADE_API_KEY."
• "No session report found": "No completed session yet. The loop may still be running — try 'status' instead."