Leer en español
Cost reporter for OpenCode — detailed cost breakdown per agent and sub-agent.
OpenCode's TUI only shows the main agent's cost. This tool reveals the full picture: main agent + all sub-agents with their individual costs, tokens, and models.
When you use OpenCode with SDD orchestrators or delegated tasks, the real cost is hidden. A session might show $0.50 but the sub-agents actually spent $5.00. opencode-costs shows you the truth.
# From GitHub
pip install git+https://github.com/caertos/opencode-costs.git
# Or clone and install
git clone https://github.com/caertos/opencode-costs.git
cd opencode-costs
pip install .This is the primary use case. Inside OpenCode, press ! to run terminal commands:
!costs
That's it. You'll see the full cost breakdown of the current session including all sub-agents.
Auto-detection: When running inside OpenCode, the tool automatically detects your current session by matching the working directory. No need to pass session IDs manually.
| Command | What it does |
|---|---|
!costs |
Cost breakdown of the current session |
!costs --all |
Global statistics across all sessions |
!costs --last 5 |
Last 5 sessions summary |
!costs --session ID |
Specific session by ID |
!costs --agent sdd-apply |
Filter by agent name |
!costs --json |
JSON output for piping |
From a regular terminal:
# Most recent session
costs
# Last 10 sessions
costs --last 10
# Global stats
costs --all
# JSON for further processing
costs --json | jq '.summary.total_cost'╭──────────────────────────────────────────────────────────────────────╮
│ COST REPORT ses_abc123 My session title │
╰──────────────────────────────────────────────────────────────────────╯
╭─────────────────────────────── RESUMEN TOTAL ────────────────────────╮
│ Cost Total $2.52 │
│ Tokens Input 574.9K │
│ Tokens Output 16.2K │
│ Reasoning 6.1K │
│ Duration 31m 38s │
╰──────────────────────────────────────────────────────────────────────╯
DESGLOSE POR AGENTE
╭───────────────────────────┬──────────┬──────────────┬────────╮
│ Agente │ Sesiones │ Costo │ % │
├───────────────────────────┼──────────┼──────────────┼────────┤
│ sdd-orchestrator-copilot │ 1 │ $0.98 │ 38.8% │
│ sdd-explore-copilot │ 2 │ $1.00 │ 39.6% │
│ sdd-apply-copilot │ 1 │ $0.54 │ 21.6% │
├───────────────────────────┼──────────┼──────────────┼────────┤
│ TOTAL │ 4 │ $2.52 │ 100% │
╰───────────────────────────┴──────────┴──────────────┴────────╯
Reads directly from OpenCode's SQLite database at ~/.local/share/opencode/opencode.db. No API keys, no external services, no tracking.
- Python 3.10+
rich(installed automatically)
MIT