What is ledger?
ledger is a Claude Code mod by BuddyLim that the record of orchestrated work: runs of units and tasks, the subagents spawned for them, each gate's verdict and the findings reviewers report, summed up in the status line while there is. It is listed under Agents & automation and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | BuddyLim |
| Repository | BuddyLim/claude-code-mod-ledger |
| Popularity | no public popularity data yet |
| Category | Agents & automation |
| Security | Review before installing (72/100) |
| Rank | #2,802 of 5,272 Claude Code mods; #209 in Agents & automation |
| License | MIT |
| Last commit | 2026-10-12 |
| Hooks | 11 events |
| Sees | Edit calls, Write calls, every prompt, every tool call, mcp__ledger__finding calls, mcp__ledger__fixed calls, mcp__ledger__plan calls, mcp__ledger__report calls, mcp__ledger__task calls, subagent spawns |
| Draws on | Pane |
Is ledger safe to install?
ledger scores 72/100 on the MCPMods security check: Review before installing. Things to review: writes files or config; watches every prompt or event. It passed 5 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes files or config | Review |
| Doesn't read environment variables | Pass |
| Watches every prompt or event | Review |
| Drives Claude (model calls, prompts) | Note |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.after | |
$.clock.every | |
$.clock.now | |
$.command.register | |
$.fs.read | reads files |
$.fs.write | writes files |
$.model.complete | drives Claude |
$.prompt.fill | writes the prompt box |
$.prompt.read | |
$.session.append | |
$.session.cwd | |
$.session.id | |
$.state.get | |
$.state.set | |
$.store.delete | keeps its own state |
$.store.get | keeps its own state |
$.store.keys | keeps its own state |
$.store.set | keeps its own state |
$.tool.register | drives Claude |
$.ui.open | draws interface |
$.ui.resolve | draws interface |
$.ui.status | draws interface |
$.ui.toast | draws interface |
How do I install ledger?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/BuddyLim/claude-code-mod-ledger claude plugin validate ./claude-code-mod-ledger/.
- Install it. Run this in your terminal, then /reload-plugins in an open session.
git clone https://github.com/BuddyLim/claude-code-mod-ledger && claude --plugin-dir ./claude-code-mod-ledger/.
Or ask Claude to set it up
Paste this into Claude Code and it installs ledger for you:
Install the "ledger" Claude Code mod from https://github.com/BuddyLim/claude-code-mod-ledger. Run claude plugin validate on it first and show me what it can access before you enable it.