Claude Code mod

subagent-budget

Counts subagent spawns per turn and toasts once when a turn goes over budget; /subagent-budget shows the count, today's peak and the budget

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/vincentlauriat/ModsTools.git
claude --plugin-dir ./ModsTools/mods/subagent-budget

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
every prompt, subagent spawns
Hooks
session.startprompt.submitagent.spawnturn.completecommand.run

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
vincentlauriat/ModsTools
Folder
mods/subagent-budget
Author
Vincent Lauriat
Type
Context & usage mods
License
MIT
Last updated
5 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is subagent-budget?

Counts subagent spawns per turn and toasts once when a turn goes over budget; /subagent-budget shows the count, today's peak and the budget It is a mod for Claude Code, from vincentlauriat/ModsTools on GitHub.

What can the subagent-budget mod access?

Its widest reach is "reads" (reads mod state, persists state, draws). It sees every prompt, subagent spawns. Like any mod, it runs with your permissions.

How do I install subagent-budget?

Clone vincentlauriat/ModsTools and start Claude Code with --plugin-dir pointing at the mod's folder (mods/subagent-budget).

More context & usage mods

fresh-start

2

mako-code/gobworks

Notices when a session is getting heavy (full context, repeated compactions, slow turns, tool errors), prepares a handoff in the background, and offers a one-press fresh start that continues from it.

Context & usage mods/plugin install

band-pack

3

baselane-sh/mods

The first six Baselane band meters in one row above the prompt: session cost, lattes, context bar, today's spend, the focus timer and the mood ring.

Context & usage mods/plugin install

cache-clock

tylergraydev/cc-mods

A prompt-cache countdown in the status line, and a Compact / Handoff / Clear band once the cache has lapsed

Context & usage mods

cache-hit-meter

3

Plagemes/claude-mods

Shows what share of input tokens came from the prompt cache.

Context & usage mods/plugin install

witness-widget

4

oMaN-Rod/claude-code-widgets

Every line of hidden context the other widgets add to your prompts, word for word, with a running size

Context & usage mods/plugin install

cache-meter

3

baselane-sh/mods

A band above the prompt with the share of prompt tokens the cache served this session (cache 87%). A high share means cheaper, faster turns.

Context & usage mods/plugin install

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