cc-super-agent

English | 简体中文

You have five projects and five Claude Code sessions open. You switch tabs, scroll back to remember where each one was, answer a permission prompt in one, forget another for an hour. The model is not the bottleneck any more. Your attention is.

cc-super-agent is an open-source implementation of the Super-agent design that DeepSeek published in October 2026, built for Claude Code from nothing but what Claude Code already ships with: no fork, no patch, no extra service.

You keep one conversation. Behind it, a Router hands each piece of work to its own Worker session in the right project, keeps track of everything in plain Markdown, and only speaks up when there is a result you can use or a decision only you can make.

Before and after

Features

• 🧭 One Router, many Workers. The Router never does the work itself, so it is always free to take your next message. Each task gets its own Worker session in its own project, loading that project's CLAUDE.md and memory.
• 🗣️ Your words, not a summary. Workers receive your request verbatim and read the original material themselves. The Router adds no plans of its own.
• 🔁 Follow-ups reach the same Worker. Every task keeps a fixed session id, so "also make the button blue" resumes the Worker that already has the context. A follow-up sent while it is busy is queued, not lost.
• 🐕 A Watchdog outside the system. A separate process, driven by cron, notices Workers that died, went silent, loop, drift off course, or wait on a prompt nobody answers. It watches the Router too.
• ♾️ Always on. On a server, the Router lives in tmux under systemd, resumes its own session after any restart, and picks up from its records.
• 🧠 A memory you can read. Your preferences go into Claude Code's memory. Your work goes into a three-layer Markdown wiki: an index, one file per task, one per project. The Router follows links one hop at a time instead of loading everything.
• 🛑 You stay in control. "Hold this" survives Worker restarts until you lift it. bin/pause stops everything at once. Workers never get permissions you did not grant.
• 🔒 Private by default. The repository tracks a whitelist of framework files. Your tasks, projects, logs and memory never leave your machine.

How it works

1. You say something. The Router decides whether it is new work, a follow-up to existing work, or neither.
2. The Router records first, then acts. It writes the task file and its line in INDEX.md, confirms in one sentence what it understood, then dispatches.
3. A Worker does the work in the project's own directory, carries local changes through to a verified result, and stops to ask the moment a decision belongs to you.
4. The Worker reports ready, blocked, failed or dropped, with a one-line result and at most one question. The Router writes you a fresh, short message. It never forwards the raw report.
5. The Watchdog checks every 15 minutes for anything that stopped without telling anyone.

The rules the Router follows are in AGENTS.md. They are the whole system: read them to know exactly what the agent will and will not do.

What a session looks like

An illustrative exchange:

You:    The homepage title is too small, make it bigger.
Router: On it: the homepage Worker will make the title font larger.

You:    Also, did the CI fix in the api repo go through?
Router: Not yet. That Worker is still running the test suite.

        … twenty minutes later …

Router: The homepage title is larger; PR #42 is ready for review.
        Question: the larger title wraps on mobile. Shorten it, or allow two lines?

Quick start

Requirements: Linux with bash, flock and uuidgen (util-linux), and the Claude Code CLI, signed in (tested with 2.1.316). The Watchdog needs cron. An always-on Router needs tmux, systemd and root.

git clone https://github.com/yingpengma/cc-super-agent.git ~/super-agent
cd ~/super-agent
claude            # this is your Router from now on

That is all you need to start. Two optional steps make it autonomous:

watchdog/install.sh                    # a Watchdog pass every 15 minutes
sudo router/install.sh                 # keep the Router running under systemd
tmux -L ccsa attach -t ccsa-router     # talk to it; detach with Ctrl-b d

Close any other Claude Code session in this directory before installing the Router service.

Repository layout

Created at run time and never committed: INDEX.md, tasks/, projects/, .runs/, .watchdog/, .router/.

Design

The architecture follows Exploring Super-agent Design: Towards a More Autonomous Agent System by the DeepSeek Harness team, and their reference implementation deepseek-ai/dsh-superagent-prototype. In their experiments, a two-layer Router–Worker system finished concurrent work faster and more predictably than a single session with a subagent tool (p95 of 15.7 versus 29.5 minutes), because a single session tends to do the work itself and keeps getting interrupted.

Their experiment, which this project's design rests on:

cc-super-agent has no pass-through, so the second row is the one closest to it: the same completion times, with more Router decisions.

How their modules map onto Claude Code:

cc-super-agent is an independent project, not affiliated with DeepSeek or Anthropic.

Roadmap

• Event sources, so the Router can notice work without being asked
• Workers on other machines
• Automated tests for the dispatch and Watchdog scripts

Ideas and issues are welcome.

FAQ

Does this modify Claude Code?
No. It uses claude -p, --session-id, --resume, SendMessage, cron, tmux and systemd, all as they ship.

Do Workers run with elevated permissions?
No. Each Worker uses your own Claude Code settings for its project. The hub never grants more, and never sends work refused in one session to another.

Will it spam me?
It is designed not to. The Router speaks only for a result, a decision or a failure, asks one question at a time, and confirms each new task in a single sentence.

Does my data end up in the repository?
No. .gitignore is a whitelist of framework files. Everything else, including your tasks, projects and logs, stays local.

Uninstall

watchdog/install.sh --remove
sudo router/install.sh --remove

Citation

If you use this project, please cite it:

@software{cc_super_agent_2026,
  author = {Ma, Yingpeng},
  title  = {cc-super-agent: Super-agent for Claude Code},
  year   = {2026},
  url    = {https://github.com/yingpengma/cc-super-agent}
}

GitHub also reads CITATION.cff.

License

MIT