cost

1# /cost -- Session & Campaign Cost Explorer
2 
3## When to Use
4 
5- `/cost` -- current session cost and burn rate
6- `/cost today` -- today's total spend
7- `/cost week` -- this week's spend
8- `/cost campaign {slug}` -- total spend for a specific campaign
9- `/cost all` -- lifetime cost summary
10- When /do routes "how much", "what's the cost", "spending", "tokens", "burn rate"
11 
12## Inputs
13 
14Optional arguments parsed from user message:
15- `today` -- filter to today's sessions
16- `week` -- filter to last 7 days
17- `campaign {slug}` -- filter to a specific campaign
18- `all` -- show all-time data
19- No argument -- show current session
20 
21## Protocol
22 
23### Step 1: READ REAL DATA
24 
25Run the session-tokens.js script to get real token data:
26 
27```bash
28node scripts/session-tokens.js              # current/latest session
29node scripts/session-tokens.js --today      # today's sessions
30node scripts/session-tokens.js --all        # all sessions (use for week/all/campaign)
31```
32 
33Also read:
34- `.planning/telemetry/cost-tracker-state.json` for live burn rate
35- `.planning/telemetry/session-costs.jsonl` for campaign attribution
36- `scripts/pricing.json` to show which pricing is being used
37 
38If `session-tokens.js` is not available or fails, fall back to session-costs.jsonl
39data and clearly mark output as "(estimated)".
40 
41### Step 2: RENDER BASED ON SCOPE
42 
43**Current session (`/cost` with no args):**
44 
45```
46=== Session Cost Report ===
47Session: {sessionId (first 8 chars)}
48Started: {relative time} ({absolute time})
49…