Command

/costs

[advanced] Show cost breakdown by provider and workflow for the current session

One command from octo.

shell

$ npx -y skills add nyldn/claude-octopus --agent claude-code

Ships 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/costs

Context preview

What this command does when you run it.

[advanced] Show cost breakdown by provider and workflow for the current session

Stats

Stars3,869

Forks362

LanguageShell

LicenseMIT

Ships with octo

Command definition

costs.md

---
command: costs
description: "[advanced] Show cost breakdown by provider and workflow for the current session"
allowed-tools: Bash, Read, Glob, Grep
---

# Cost Dashboard (/octo:costs)

**Your first output line MUST be:** `🐙 Octopus Cost Dashboard`

Display a cost breakdown by provider and workflow for the current session (and cumulative history).

## EXECUTION CONTRACT (Mandatory)

When the user invokes `/octo:costs`, you MUST follow these steps in order.

### STEP 1: Locate Usage Data

Search for session usage data in these locations (check all, use whichever exist):

```text
~/.claude-octopus/usage/           # Per-session usage logs
~/.claude-octopus/routing.log      # Routing decisions with timestamps
~/.claude-octopus/sessions/        # Session state files
.claude-octopus/                   # Project-local usage data
```

Use the Bash tool to list and read files:

```bash
ls -la ~/.claude-octopus/usage/ 2>/dev/null || echo "No usage directory"
ls -la ~/.claude-octopus/routing.log 2>/dev/null || echo "No routing log"
ls -la ~/.claude-octopus/sessions/ 2>/dev/null || echo "No sessions directory"
ls -la .claude-octopus/ 2>/dev/null || echo "No project-local usage data"