Meter History

Your objective is to display historical CocoMeter data.

Before proceeding, verify that .cocoplus/ exists. If not: output "CocoPlus not initialized in this directory. Run $pod init to begin." Then stop.

Parse argument: $meter history [n], n defaults to 10.

Read .cocoplus/meter/history.jsonl. If it does not exist or is empty: Output: "No meter history yet. CocoMeter records history when sessions end. Ensure CocoMeter is enabled ($meter on) and complete a session." Then stop.

Read the last N JSON objects from history.jsonl (one per line).

Output:

# CocoMeter, Session History

Showing last [N] sessions:

| Session | Started | Duration | Tools Called | SQL Statements | Writes |
|---------|---------|----------|-------------|----------------|--------|
[one row per session]

## Totals (last [N] sessions)
Total tools called: [sum]
Total SQL statements: [sum]
Total writes: [sum]
Estimated total tokens: [sum]

Anti-Rationalization

Shortcut / Temptation	Why It Fails
Read all lines from history.jsonl regardless of N argument	Large projects accumulate hundreds of sessions; always respect the N limit to avoid excessive output
Show history when history.jsonl is empty without a clear explanation	A blank output looks like a bug; always explain that no sessions have been recorded yet and how to start

Exit Criteria

• A session history table with columns Session, Started, Duration, Tools Called, SQL Statements, Writes is output
• At most N sessions are shown (N from argument, default 10)
• Totals row showing sums across all displayed sessions is shown at the bottom