Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@gonzih/cc-agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

cc-agent

MCP server for spawning Claude Code agents in cloned repos. Give Claude Code the ability to branch itself — clone a repo and kick off a sub-agent to work on it autonomously.

What it does

Exposes 5 MCP tools:

Tool	Description
`spawn_agent`	Clone a git repo and run Claude Code on a task inside it
`get_job_status`	Check status of a spawned job
`get_job_output`	Stream output lines from a job
`list_jobs`	List all jobs
`cancel_job`	Cancel a running job

Claude submits a job → cc-agent clones the repo → starts Claude Code in it with the task → returns immediately with a job ID → caller polls for output.

Quickstart

# Add to Claude Code MCP config
claude mcp add cc-agent -- npx @gonzih/cc-agent

Set one of:

CLAUDE_CODE_TOKEN=sk-ant-oat01-...    # OAuth token
ANTHROPIC_API_KEY=sk-ant-api03-...    # API key

Then restart Claude Code.

Example usage (from within Claude Code)

spawn_agent({
  repo_url: "https://github.com/yourorg/yourrepo",
  task: "Find all TODO comments and create a summary in TODO_SUMMARY.md",
  create_branch: "agent/todo-summary"
})
// → { job_id: "abc-123", status: "started" }

get_job_output({ job_id: "abc-123" })
// → { lines: ["[cc-agent] Cloning...", "..."], done: false }

Environment variables

Variable	Description
`CLAUDE_CODE_TOKEN`	Claude OAuth token (sk-ant-oat01-...)
`ANTHROPIC_API_KEY`	Anthropic API key (sk-ant-api03-...)

Per-job token override available via claude_token argument on spawn_agent.

MCP config example

{
  "cc-agent": {
    "command": "npx",
    "args": ["@gonzih/cc-agent"],
    "env": {
      "ANTHROPIC_API_KEY": "sk-ant-api03-..."
    }
  }
}

How it works

spawn_agent creates a job and returns immediately
In background: git clone --depth 1 <repo> into a temp dir
Optionally checks out a branch or creates a new one
Runs claude --print --output-format stream-json --dangerously-skip-permissions "<task>"
Streams output into job record
Temp dir cleaned up 10 minutes after job finishes
Jobs expire after 1 hour

cc-tg — Claude Code Telegram bot (same author)

@gonzih/cc-agent