Command
/usage
[advanced] Per-provider, per-skill, and per-MCP-server cost and token breakdown (Claude Code /usage schema)
One command from octo.
shell
$ npx -y skills add nyldn/claude-octopus --agent claude-codeShips with octo. Installing the plugin gets this command.
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/usage
Context preview
What this command does when you run it.
[advanced] Per-provider, per-skill, and per-MCP-server cost and token breakdown (Claude Code /usage schema)
Stats
Stars3,869
Forks362
LanguageShell
LicenseMIT
Ships with octo
Command definition
usage.md
--- command: usage description: "[advanced] Per-provider, per-skill, and per-MCP-server cost and token breakdown (Claude Code /usage schema)" allowed-tools: Bash, Read, Glob --- # Usage Report (/octo:usage) **Your first output line MUST be:** `🐙 Octopus Usage Report` Produce a per-provider, per-skill, and per-MCP-server cost and token breakdown from recorded Octopus usage artifacts. Output schema matches Claude Code's native `/usage` report (`claude-code/usage-v1`), so results can be compared or merged with the host session's own usage pane. ## EXECUTION CONTRACT (Mandatory) ### STEP 1: Run the report helper ```bash ${CLAUDE_PLUGIN_ROOT}/scripts/helpers/usage-report.sh --format table ``` If the user asked for machine-readable output (or passed `--format json`): ```bash ${CLAUDE_PLUGIN_ROOT}/scripts/helpers/usage-report.sh --format json ``` The helper reads: - `~/.claude-octopus/usage/*.jsonl` — JSONL records written by `hooks/subagent-stop-gate.sh` and provider adapters - `~/.claude-octopus/results/**/summary.json` — council and workflow roster artifacts (query counts) ### STEP 2: Present the breakdown Show the helper's table output directly. Then add a one-paragraph interpretation:
