rd-ledger
by Joseph Ayoub · ★ 0 · updated 12 Oct 2026
Contemporaneous R&D time and AI-usage ledger: engagement hours by business component, list-price usage estimates, a weekly review with buttons, a CPA export, an optional bridge to rd-tracker, and a live Usage pane (cost, context, rate limits, models, subagents, code changes) behind one footer chip. Metadata only, nothing leaves the Mac.
Install
/plugin marketplace add Joseph-Ayoub/claude-mods/plugin install rd-ledger@joseph-modsThen run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.
What it hooks into
From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.
- Events
session.startclassic.SessionStartprompt.submitturn.completeturn.steptool.callsession.measureclassic.PostModelSwitchsession.endcommand.runui.render- API calls
$.agent.list$.clock.after$.clock.every$.clock.now$.command.register$.env.get$.fs.exists$.fs.list$.fs.read$.fs.stat$.fs.write$.process.run$.session.cwd$.session.id$.session.model$.session.repo$.session.surfaces$.session.usage$.state.get$.state.set$.ui.ask$.ui.close$.ui.log$.ui.open$.ui.panes$.ui.resolve$.ui.toast- Draws
PromptHintSessionModePane- Can see
classic hooksevery promptEdit|Write|NotebookEdit calls- Reach
- level 2 of 3 runs processeswrites filesreads filesreads env varsreads mod statedraws
Origin
- How it got here
- Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
- Repository
- github.com/Joseph-Ayoub/claude-mods
- Path in repo
rd-ledger- Source commit
86951e2the exact code the scan read- Author
- Joseph Ayoub @Joseph-Ayoub
- License
- MIT
- First published
- Last pushed
- First listed here
Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.
More from Joseph-Ayoub/claude-mods
cockpit
Joseph-Ayoub/claude-mods
One band above the prompt: quick replies, branch/PR/CI standing, decision cards, waiting-on-you items, standing-rule capture and a Hand off chip at natural breaks.
handoff
Joseph-Ayoub/claude-mods
/handoff: a handoff note written from this session (secret shapes redacted) under ~/.claude/handoffs/, the conversation cleared, the next prompt pre-filled to continue from the note. What mem-gauge's Hand off button and the cockpit chip run.
mem-gauge
Joseph-Ayoub/claude-mods
A pressable memory gauge under the composer and a /mem pane: what is using this Mac's RAM across Claude sessions, agents, models and apps, with rule-based advice.
merge-lane
Joseph-Ayoub/claude-mods
One merge lane per repo across concurrent sessions: a priority queue, a Bash merge gate, auto-release on merge, and a wake-up for the next session.
model-pin
Joseph-Ayoub/claude-mods
Pin a project to one model, show a drift badge when the session leaves it, and re-apply the pin once.
secret-guard
Joseph-Ayoub/claude-mods
Holds a prompt that carries a credential shape and offers to send it redacted, telling Claude where the value really lives.
stall-watch
Joseph-Ayoub/claude-mods
Auto-retries transient API failures (capped), pins a usage-limit countdown, and can resume after a limit reset (opt-in via /stall-watch).
usage-gauge
Joseph-Ayoub/claude-mods
(superseded by rd-ledger) A live cost chip in the prompt footer and a /spend Usage pane: the session's cost, context by category, rate limits, tokens and cache hit per model, subagent share and code changes, without /usage landing in the transcript.
wrap
Joseph-Ayoub/claude-mods
/wrap close-out command: deterministic git/gh/CI/worktree checklist where unknown is never green.