# DayLedger — your AI coding day, in one report

**DayLedger** reads your Claude Code logs (`~/.claude`) and turns each day into a
clean, shareable work report — sessions, output, focus, cost — then files every
report into a browsable **Library** with filters and a score-over-time chart.

100% local. Your transcripts never leave your machine. The only dependency is
PyYAML. Free, from [K&E Studios](https://kestudios.dev).

---

## Install (macOS / Linux)

```bash
unzip dayledger.zip && cd dayledger
./install.sh              # set up + generate your first report
./install.sh --schedule   # …and auto-generate a report at 10pm and 8am (macOS)
```

That's it. The installer:
- creates a private workspace at `~/DayLedger`,
- installs the engine into its own venv,
- generates your first report and builds the **Library** app,
- adds a **DayLedger** launcher to your Desktop,
- with `--schedule`: runs nightly (10pm) + morning (8am) automatically and keeps
  a live viewer at <http://127.0.0.1:7099>.

Open the app any time by double-clicking **DayLedger** on your Desktop, or open
`~/DayLedger/index.html`.

## Use it by hand

```bash
~/DayLedger/.venv/bin/python3 -m dayledger --help
# one-off report for today:
~/DayLedger/.venv/bin/python3 -m dayledger report --date today --out today.html
# add a snapshot to the Library:
~/DayLedger/.venv/bin/python3 -m dayledger snapshot --label nightly
# browse everything:
~/DayLedger/.venv/bin/python3 -m dayledger serve
```

## Uninstall

```bash
rm -rf ~/DayLedger ~/Desktop/DayLedger.command
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.kestudios.dayledger.*.plist 2>/dev/null
rm -f ~/Library/LaunchAgents/com.kestudios.dayledger.*.plist
```

---

Requires Python 3.8+ and Claude Code logs at `~/.claude`. Set
`DAYLEDGER_CLAUDE_DIR` if yours live elsewhere.
