Skip to content

About

Native agent teams. Under control. Hard worker limits, live team visibility, and portable configuration for Claude Code.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

83 Commits

Folders and files

Repository files navigation

Claude Team Kit: Native agent teams. Under control.

Build with a team. Stay in control.

Turn complex tasks into coordinated Claude Code agent teams.
Set hard limits, watch teammates work, and follow task dependencies live.

Native teams. Real visibility. Your rules.

Install CTK  ·  Watch Mission Control  ·  How it works

CI MIT license

Recording of a real Claude Code session: one plain sentence starts a team, three teammates work, and a click on the CTK line above the prompt opens Mission Control beside the transcript with workers, a task graph whose nodes turn from ready to running to done, and usage

A real Claude Code session, not a mockup. One sentence starts the team; one click opens Mission Control. Account details are masked, and results vary from run to run. Recording notes · MP4 · GIF

Three reasons to use CTK

Coordinated native teams

One goal, several teammates, clear tasks and dependencies. Claude Code's own Agent Teams do the work; CTK's skill guides the lead to split the goal into verifiable tasks and to check the result before calling it done.

Hard worker limits

Choose how many native teammates may be live at once (default 5, from 1 to 12). A spawn above the limit is refused and its task stays pending. Claude Code itself documents no such limit.

Mission Control

See workers, tasks, dependencies and usage without leaving Claude Code. It is read-only: it never starts, stops or changes anything.

Install

Two ways, both through Claude Code's own Plugin Manager.

Install with your AI Agent

Paste this into Claude Code (or another coding agent that can run shell commands):

Install Claude Team Kit (CTK), a Claude Code plugin, by following https://raw.githubusercontent.com/tc3oliver/claude-team-kit/main/INSTALL.md

Manual install

In Claude Code:

/plugin marketplace add tc3oliver/claude-team-kit
/plugin install ctk@ctk-kit

Then run /reload-plugins (or restart). CTK needs Claude Code 2.1.287 or newer.

Turn on Agent Teams. They are experimental and off by default, and a plugin cannot switch them on. Add this to the env object in ~/.claude/settings.json (keep your other settings), then restart:

"env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" }

Run /ctk-doctor to check the setup: it changes nothing and prints the exact fix for anything missing. Details, Claude 5.x notes and options: Installation.

Your first team

Ask in plain words:

Use a team to implement this feature, write tests, and review the result.

Or be explicit with /ctk:team <goal>. The explicit command always loads the team skill. A plain sentence usually does too, but the model decides, so use the command when you want to be sure (how it works). Then click CTK ▸ above the prompt to open Mission Control.

How CTK works

Illustration: one goal becomes eight tasks with dependencies; only ready tasks start; three native teammates work at once and a fourth ready task waits; the lead hands the next ready task to an idle teammate; the lead runs the final verification

Conceptual illustration. The scenario and timings are invented; the recording at the top is the real session. MP4

Plan → Coordinate → Execute → Verify

Claude Code provides the agent team and its shared task list. CTK's skill guides the lead through the four steps, and CTK's mod enforces the limit on native teammates. CTK has no scheduler of its own. Full division of work: How CTK works.

Mission Control

Click the CTK ▸ line above the prompt, or run /ctk-mission. Seven views: Overview, Workers, Tasks, Usage, Config, Stats and Doctor; keys 1 to 7 switch, Esc closes. Figures come from Claude Code's own events and API, and anything CTK could not observe reads unavailable, never a made-up zero.

When a team finishes, /ctk-report prints a Markdown summary (tasks, spawns, cost, changed files) to paste into a PR body. Desktop notifications say when a teammate fails or all have finished.

Mission Control Workers view beside the transcript: three workers on Sonnet 5.5, each with its task, tool-call count, elapsed time and last activity
Live workers
Who is running what, on which model, and how recently it did something.

Mission Control Tasks view beside the transcript: five finished tasks fan in to a running npm test task, which leads to the report task
Task dependency graph
Drawn only from the dependencies the lead declared; waiting, ready, running and done are distinct.

Mission Control Usage view beside the transcript: 5-hour and weekly limits with reset times, context use, session cost and tool calls
Usage
5-hour and weekly limits, context and session cost, as Claude Code reports them.

Stills from the recording above; tap one for full size. More layouts, at other widths, are in the synthetic-data screenshots, which are labelled as such.

Everything else

  • Models by role. Explorers on Haiku, implementers and reviewers on Sonnet, the high-risk reviewer on Opus, unless a spawn names a model. An optional read-only designer on Opus writes UI/UX briefs; it is new on main and has not yet been part of a recorded run.
  • Risk-based review. /ctk:review scales reviewer depth to the risk of the change.
  • Debugging workflow. /ctk:debug asks for a failing reproduction before a fix; when a standalone debugging skill is installed, generic debugging should use one diagnosis protocol, not two.
  • Optional Backlog / BetFirst composition. CTK runs independently; when explicitly combining tools, the team lead alone owns durable task updates. Workflow contract.
  • Natural-language control. Ask in words for a team or for a setting change, such as "set the worker cap to 2"; the change applies only after you press Confirm in Mission Control (details).
  • Usage HUD. A team line above the prompt with the model, 5-hour and weekly usage, agents against the limit, tasks and cost, fitted to your terminal width. It reads only what Claude Code hands it: no network calls, no model calls.
  • Portable configuration. Change options with /plugin configure ctk@ctk-kit. The optional ctk CLI syncs a profile between machines through a git repository you own, with a secrets scan before every publish (Configuration).
  • Small footprint. The plugin adds about 480 tokens to a session (measured with a real call). No speed, cost or token-saving claim is made.

Limitations

  • Agent Teams are experimental, and Mods, which carry the limit and the team line, are early access. Where Mods are missing, /ctk:team says the limit and the team line are off.
  • The hard limit counts native teammates only. Ordinary subagents are not counted or limited.
  • The team workflow is guided by a skill that the model may follow imperfectly. CTK is not another scheduler.
  • Used interactively on macOS. Linux and Windows are covered by CI only, and the agent install prompt has not been run end to end.
  • Status: public preview, released as the GitHub pre-release v0.1.9: ctk_goal tracks which goal owns each teammate and when they have left, an opt-in command puts the built-in Explore on Haiku, and a completed task stays unverified until the lead checks it. The install commands above follow main.

More: Limitations · Architecture · Threat model

Documentation

Installation · How CTK works · Mission Control · Natural language · Configuration · Architecture · Limitations · Recordings · Verification record · Comparison with OMC, superpowers and claude-hud · Coming from OMC · Rollback


Contributing · Code of Conduct · Security · Changelog · MIT License · Third-party notices

About

Native agent teams. Under control. Hard worker limits, live team visibility, and portable configuration for Claude Code.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages