ctkprobe · Claude Code mod

README

<h2 align="center">Build with a team. Stay in control.</h2>

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

<a href="#install">Install CTK</a>  ·  <a href="#mission-control">Watch Mission Control</a>  ·  <a href="#how-ctk-works">How it works</a>

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 the checklist at
https://raw.githubusercontent.com/tc3oliver/claude-team-kit/main/INSTALL.md

Rules: use only Claude Code's native Plugin Manager (`claude plugin ...`); no other installer, no `curl | bash`,
no `npm install`. Check `claude --version` and any existing CTK install first. Show me the exact change to
settings.json and wait for my yes before editing it; merge only, and keep my other plugins, MCP servers, hooks and
settings. Do not uninstall or disable anything else, including OMC. Tell me which steps only I can run
(`/reload-plugins` or a restart, then `/ctk-doctor`) and what the result should look like.

The agent follows INSTALL.md: it installs with the two commands below, adds the Agent Teams setting only after you agree, and asks you to reload and run /ctk-doctor.

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

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.

<a href="docs/assets/mission-control-f-workers.svg"><img src="docs/assets/mission-control-f-workers.svg" alt="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" width="640"></a> Live workers Who is running what, on which model, and how recently it did something.

<a href="docs/assets/mission-control-f-poster.svg"><img src="docs/assets/mission-control-f-poster.svg" alt="Mission Control Tasks view beside the transcript: five finished tasks fan in to a running npm test task, which leads to the report task" width="640"></a> Task dependency graph Drawn only from the dependencies the lead declared; waiting, ready, running and done are distinct.

<a href="docs/assets/mission-control-f-usage.svg"><img src="docs/assets/mission-control-f-usage.svg" alt="Mission Control Usage view beside the transcript: 5-hour and weekly limits with reset times, context use, session cost and tool calls" width="640"></a> Usage 5-hour and weekly limits, context and session cost, as Claude Code reports them.

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.
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.1. The earlier v0.1.0 predates the redesigned Mission Control, the designer agent and the default limit of 5. 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

Source 1 files

hooks/register.mjs 29 lines

1// Throwaway probe, not part of CTK: logs what Claude Code sends to `agent.spawn` for each Agent call, and
2// what the next hook answered, so the boundary "which calls are teammates" can be observed instead of assumed.
3// It changes nothing: every spawn is passed on untouched. The log path is CTK_PROBE_LOG (default: spawn-probe-log.json
4// in the session's working directory).
5const rows = []
6async function note($, e, result) {
7  rows.push({
8    name: e.name ?? null,
9    subagentType: e.subagentType,
10    isTeammate: e.isTeammate ?? null,
11    fork: e.fork,
12    background: e.background,
13    provider: e.provider,
14    keys: Object.keys(e).sort(),
15    result,
16  })
17  const path = (await $.env.get('CTK_PROBE_LOG').catch(() => undefined)) ?? 'spawn-probe-log.json'
18  try {
19    await $.fs.write(path, JSON.stringify(rows, null, 1))
20  } catch {}
21}
22export const register = on => {
23  on('agent.spawn', async ($, e, next) => {
24    const r = await next(e)
25    await note($, e, r.deny !== undefined ? { deny: String(r.deny).slice(0, 80) } : { agentId: r.agentId ?? null, teammateId: r.teammateId ?? null })
26    return r
27  })
28}
29