vibe-ledgerlisted
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