← ClaudeAtlas

vibe-ledgerlisted

Generates a full project cost report as a self-contained HTML file from vibe/cost/history.json. Opens automatically in the browser. Tracks spend per session, per task, per phase, and per day. Shows task size breakdown (S/M/L avg costs), session burn with dot indicators, token composition, efficiency metrics, waste pattern advice, and project cost forecast. All plain English — readable by non-technical stakeholders. Triggered automatically at the end of every cost: session. Also triggers on "ledger:", "generate ledger", "show cost report", "open ledger", "cost report", "how much have I spent", "show me the report". Requires vibe/cost/history.json to exist — run cost: first if it doesn't. Zero dependencies — uses Python stdlib only, works on any machine.
aakashdhar/vibe-skill · ★ 7 · Data & Documents · score 68
Install: claude install-skill aakashdhar/vibe-skill
# Vibe Ledger Generates a visual cost report from your project's cost history. Reads `vibe/cost/history.json`. Writes `vibe/cost/ledger/index.html`. Opens in browser. **No dependencies. No installs. Works on Mac, Linux, and Windows.** --- ## When this runs **Automatically** — vibe-cost calls this at the end of every session after writing history.json. **Manually** — when the user says: - `ledger:` — regenerate and open - `show cost report` / `open ledger` / `generate ledger` - `how much have I spent` — if history.json exists --- ## Step 1 — Check history.json exists ```bash ls vibe/cost/history.json 2>/dev/null && echo "EXISTS" || echo "MISSING" ``` If missing: > "No cost history found yet. Run `cost:` after your next session to start tracking, > then `ledger:` to generate the report." Stop here if missing. --- ## Step 2 — Run the generator ```bash # Resolve the generator across install layouts (flat install or plugin marketplace) GEN=$(ls ~/.claude/skills/vibe-ledger/scripts/generate.py \ ~/.claude/plugins/marketplaces/*/skills/vibe-ledger/scripts/generate.py 2>/dev/null | head -1) python3 "$GEN" ``` The script: 1. Finds `vibe/cost/history.json` from the current project directory 2. Computes all metrics — totals, averages by task size, day breakdowns, efficiency ratios 3. Generates `vibe/cost/ledger/index.html` — self-contained, no external dependencies 4. Opens it in the default browser automatically 5. Prints a summary to the terminal --- ## Step