Claude Code mod

budget-governor

Enforces session and daily spend caps: a live gauge above the prompt, a wrap-up nudge at 80%, and new prompts refused at the cap

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/ccdwyer/budget-governor.git
claude --plugin-dir ./budget-governor/.

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

What it can access

Reach
L2Writes or runs: drives Claude, reads mod state, persists state, draws
Sees
every prompt, every tool call
Draws in
AbovePrompt
Hooks
session.startsession.endcommand.runturn.startturn.completeprompt.submittool.callui.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

Repository
ccdwyer/budget-governor
Folder
.
Author
Chris Dwyer
Type
Context & usage mods
License
MIT
Last updated
2 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is budget-governor?

Enforces session and daily spend caps: a live gauge above the prompt, a wrap-up nudge at 80%, and new prompts refused at the cap It is a mod for Claude Code, from ccdwyer/budget-governor on GitHub.

What can the budget-governor mod access?

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

How do I install budget-governor?

Clone ccdwyer/budget-governor and start Claude Code with --plugin-dir pointing at the mod's folder (.).

More context & usage mods

branch-usage

gpr/claude-code-mods

Tracks tokens and cost per model, agent and session for every session on a git branch, in a right pane.

Context & usage mods/plugin install

burn

PickleBoxer/burn

Rate limits, usage credits and spend above the prompt, with a /burn pane for the last 7 days

Context & usage mods

brain-dash

sillss1/brain-dash

Context and plan limits with a burn-rate projection, plus a deadline radar from a plain file or your own command, beside the code and above the prompt

Context & usage mods/plugin install

burn-guard

ozlar34/claude-code-mods

Guards the 5h usage window: caps expensive-tier spawns per turn, keeps Fable spawns manual-only, draws a colour-coded usage gauge above the prompt (5h bar, reset time, turn burn, cache warmth, context size), and offers handoff + clear past a context size.

Context & usage mods

boot-sequence

ccdwyer/boot-sequence

A BIOS-style boot screen when a session starts: real checks of git, toolchains, devices, ports, context and disk, typed out and flipped to OK, WARN or FAIL

Context & usage mods

burnbaby

rohit-adak/burnbaby

Session usage dashboard: context, cache, 5h/weekly limit bars with time-vs-limit pace, anomaly flags and one-press fixes (compact, sonnet, cache warm-up).

Context & usage mods/plugin install

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