subagent-spawn-cap

v1.0.0

A total-spawns-per-session budget for subagents: a PreToolUse guard on the Agent tool that counts every spawn in a session (nested spawns from inside subagents included), asks for approval at SPAWN_CAP_ASK (default 20) and every SPAWN_CAP_ASK_STEP spawns after it (default 10), and denies at SPAWN_CAP_DENY (default 60): prompts at 20, 30, 40, 50, hard stop at 60. Closes the gap left when Claude Code 2.1.224 removed its native per-session spawn cap; the native concurrency and depth caps bound the rate, not the total. Append-only per-session ledger, so parallel spawns in one turn are all counted. SPAWN_CAP_ALLOW=true lets spawns through while set, still counted.

Claude Code

By Karan BansalLicense: MIT533 GitHub starsUpdated 2 weeks ago

Directory evidence

Runtimes: Claude Code
Parsed components: 0 skill or MCP entries
Source updated: Oct 4, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install subagent-spawn-cap for Claude Code

Installs for the current user

claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install subagent-spawn-cap@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/karanb192/claude-code-hooks

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/subagent-spawn-cap/.

Plugin files

plugins/subagent-spawn-cap/

└── .claude-plugin/plugin.json

Plugin manifests1

plugins/subagent-spawn-cap/.claude-plugin/plugin.json

{
  "name": "subagent-spawn-cap",
  "description": "A total-spawns-per-session budget for subagents: a PreToolUse guard on the Agent tool that counts every spawn in a session (nested spawns from inside subagents included), asks for approval at SPAWN_CAP_ASK (default 20) and every SPAWN_CAP_ASK_STEP spawns after it (default 10), and denies at SPAWN_CAP_DENY (default 60): prompts at 20, 30, 40, 50, hard stop at 60. Closes the gap left when Claude Code 2.1.224 removed its native per-session spawn cap; the native concurrency and depth caps bound the rate, not the total. Append-only per-session ledger, so parallel spawns in one turn are all counted. SPAWN_CAP_ALLOW=true lets spawns through while set, still counted.",
  "version": "1.0.0",
  "author": {
    "name": "Karan Bansal",
    "url": "https://github.com/karanb192"
  },
  "homepage": "https://github.com/karanb192/claude-code-hooks",
  "license": "MIT",
  "keywords": [
    "claude-code",
    "hooks",
    "safety",
    "guardrails",
    "subagents",
    "cost",
    "pretooluse"
  ]
}