Summary
Turns Claude Code into an orchestratable sub-agent by spawning and controlling headless sessions through the claude-wrap library. You get eight tools: spawn sessions in a working directory, send prompts with claude_ask and wait for parsed state, fire raw input with claude_send for long tasks, poll status for busy/mode/tokens/permissions, grab transcript snapshots, list all sessions, and approve or deny permission prompts explicitly instead of bypassing them. Built on node-pty, requires the claude CLI on your PATH. The primary use case is letting one Claude instance manage a fleet of other Claude Code sessions as workers, with full lifecycle control and state parsing for each.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
claude-wrap-mcp
An MCP server that lets any MCP-capable agent
(Claude Code, Claude Desktop, Cursor, …) spawn and drive Claude Code sessions
— effectively turning Claude Code into an orchestratable sub-agent fleet. Built
on the claude-wrap library.
Requirements
- Node ≥ 18
- The
claudeCLI on yourPATH(the sessions run real Claude Code). claude-wrappulls the nativenode-ptyaddon, so a prebuilt binary or a C/C++ toolchain is needed at install time.- Spawning headless sessions works cross-platform; attaching to visible windows is Windows-first.
Install & register
npm install -g claude-wrap-mcp
# then, in Claude Code:
claude mcp add claude-wrap -- claude-wrap-mcp
Or via JSON config (.mcp.json / claude_desktop_config.json):
{
"mcpServers": {
"claude-wrap": { "command": "npx", "args": ["-y", "claude-wrap-mcp"] }
}
}
Once published, it's also discoverable in the MCP Registry as io.github.Alex-Kaff/claude-wrap-mcp.
Tools
| Tool | What it does |
|---|---|
claude_spawn | Start a headless session in an absolute cwd. Returns a sessionId. |
claude_ask | Send a prompt, wait for idle, return transcript tail + parsed state. Returns status:"busy" on timeout (not an error). |
claude_send | Send raw input (text / line / key) without waiting — for long tasks; then poll. |
claude_status | Parsed state: busy, mode, tokens, pending permission prompt, todos, tool calls. |
claude_snapshot | The rendered transcript lines. |
claude_list | All sessions — in-process (spawned here) and external (discovered windows). |
claude_resolve_permission | approve / deny a pending permission prompt. |
claude_stop | Shut down an in-process session. |
Permission prompts are surfaced, not auto-bypassed: when claude_ask /
claude_status report a pending permissionPrompt, resolve it with
claude_resolve_permission.
Control models
- In-process (primary): the server owns a
claude-wrapClaudeManagerand drives headless sessions directly — full parsed state and lifecycle. - External (Windows-first): sessions launched elsewhere (visible windows)
are discovered via the registry and driven over their pipe; parsed operations
are delegated to the
claude-wrap-injectbin. Best-effort;claude_stopis declined for instances this server did not spawn.
Develop
pnpm install
pnpm --filter claude-wrap-mcp build # tsup -> dist/ (ESM + .d.ts, shebang on the bin)
pnpm --filter claude-wrap-mcp test # vitest, in-memory MCP client against fakes
pnpm --filter claude-wrap-mcp inspect # @modelcontextprotocol/inspector on the built server
License
MIT © Alex Kaffetzakis
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →