Claude Code mod

agent-governor

Watches subagents in long, fan-out-heavy sessions: a [GOV] band while agents run (count, peak, tokens) and a toast when too many run at once or an agent or the session goes over its token budget. Warn-only by default; /governor caps on asks before over-limit spawns and stops over-budget agents, /governor route picks a model per agent type.

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add aecheman27-gif/claude-mods
/plugin install agent-governor@my-claude-mods

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L1Reads: reads mod state, persists state, draws
Sees
subagent spawns, every tool call
Draws in
AbovePrompt
Hooks
session.startcommand.runagent.spawnturn.stepturn.completetool.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

Folder
agent-governor
Marketplace
my-claude-mods
Author
aecheman27-gif
Last updated
16 October 2026

FAQ

What is agent-governor?

Watches subagents in long, fan-out-heavy sessions: a [GOV] band while agents run (count, peak, tokens) and a toast when too many run at once or an agent or the session goes over its token budget. Warn-only by default; /governor caps on asks before over-limit spawns and stops over-budget agents, /governor route picks a model per agent type. It is a mod for Claude Code, from aecheman27-gif/claude-mods on GitHub.

What can the agent-governor mod access?

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

How do I install agent-governor?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add aecheman27-gif/claude-mods and then /plugin install agent-governor@my-claude-mods.

More context & usage mods

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