# Clade Report

> Get session reports, cost breakdowns, and blocker details from Clade

- Skill: `shenxingy/clade-report` (Agent Skill)
- Install (CLI): `npx skillmds add shenxingy/clade-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shenxingy/clade-report/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: shenxingy (https://skillmd.com/u/shenxingy)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/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:**
```json
{
  "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."