Claude Code mod

ledger

DURABLE: counts turns and tool calls per session ($.state) and for all time ($.store), shown in a band above the prompt

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/RobGruhl/claude-mods.git
claude --plugin-dir ./claude-mods/samples/ours/ledger

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L1Reads: reads mod state, persists state, draws
Sees
classic hooks, every tool call
Draws in
AbovePrompt
Hooks
session.startclassic.SessionStarttool.callturn.completeui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Folder
samples/ours/ledger
Author
Rob Gruhl
License
MIT
Last updated
9 October 2026

FAQ

What is ledger?

DURABLE: counts turns and tool calls per session ($.state) and for all time ($.store), shown in a band above the prompt It is a mod for Claude Code, from RobGruhl/claude-mods on GitHub.

What can the ledger mod access?

Its widest reach is "reads" (reads mod state, persists state, draws). It sees classic hooks, every tool call. It draws in AbovePrompt. Like any mod, it runs with your permissions.

How do I install ledger?

Clone RobGruhl/claude-mods and start Claude Code with --plugin-dir pointing at the mod's folder (samples/ours/ledger).

More context & usage mods

last-call

Sunkanxx/Mods

Stops work at a clean point before the 5-hour (or 7-day) usage limit, keeps the prompt cache warm while waiting, and continues the work after the reset.

Context & usage mods/plugin install

leitstand

fbrogno/claude-mods

Leitstand: Live-Dashboard für alle Claude-Code-Sitzungen: Titel statt Kürzel, leere Sitzungen gebündelt, kontoweite Limits, Crew-Übersicht je Sitzung mit gemessenen Token-Zahlen, Kosten und Cache-Trefferquote; Subagents als animierte Pixel-Männchen.

Context & usage mods/plugin install

kontext-anzeige

hb03/claude-mods

Hinweise, wann /compact, /clear oder Weitermachen sinnvoll ist: Kontextfüllung, Prompt-Cache, Auto-Compact und Limits. Schreibt die Werte für die Statuszeile, die Warnungen zeigt offene-punkte über der Eingabe; /kontext zeigt Details, /kontext test probiert Einblendung, Statuszeile und Systemmeldung aus.

Context & usage mods/plugin install

limit-lens

cristi71000/limit-lens

A band above the prompt showing this session's share of your usage limits, its API-equivalent cost, and what the same work would cost on each Claude model

Context & usage mods/plugin install

keyfob

shiran-yu/keyfob

Keep your API keys and tokens out of your Claude Code conversations: tokens pasted as keyfob: lines are stored before the model sees them, Claude asks for a key through the /keyfob panel, a guard stops Bash commands that would print one, and each command gets only the keys it needs from the OS keystore

Context & usage mods/plugin install

limit-meter

Alyan-khattak/Claude-Code-Mods

Your plan's 5-hour and weekly usage limits above the prompt: percent used, time to reset, used today, with warnings at 75% and 90%.

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.