KCC is a terminal-native multi-agent orchestrator. Run many coding agents in parallel — Claude Code, Codex, Copilot, and more — each in its own pane, its own git worktree, and its own account, all driven from one control pane.
- Per-pane account isolation. Every pane gets its own agent login
(
CLAUDE_CONFIG_DIR/CODEX_HOMEper pane), so N simultaneous agent sessions never clobber each other's credentials — and the isolation survives pane restarts. - First-party multiplexer (KOYDOMUX). PTY-backed panes on Windows, macOS, and Linux — no tmux required (tmux and Windows Terminal backends are also supported).
- Git worktree isolation. Each agent works on its own branch in its own worktree; merges to the default branch happen only on your command.
- Headless + scriptable. A stable CLI contract (stdout = data,
stderr = logs, exit codes 0/1), an MCP server (
kcc mcp serve) so any MCP host can drive the fleet, andKCC::control lines for agents already running inside panes. - Operator safety. Pre-launch conflict detection (two agents editing the same repo), repo-writer freezing, governance previews, durable sessions that survive restarts, and cross-session memory.
Requires Node.js 20+ and git.
npm install
npm run build
npm link # exposes the `kcc` command globallykcc init --starter # generic 2-slot manifest resolved against THIS machine
kcc doctor # verify tools, config, and pane isolation
kcc launch --dry-run --focus
kcc launch --focus # open a 2-pane sessionkcc init --starter writes machine-local config to ~/.kcc/ — nothing is
ever written back into the repo. Edit
~/.kcc/config/agent-manifest.json to add accounts, slots, repos, and
presets for your own machines.
| Area | Commands |
|---|---|
| Setup | init, doctor, configure, env, sync |
| Launch | launch, run, layout, watch, resume |
| Panes / mux | `mux serve |
| Agents | agent, do, route, ask, research, goal, chat |
| Repos / git | repos, repo, worktree, merge, ship, review, status |
| Governance | govern, rules, verify, tasks |
| Memory | memory, recall, brain, graph |
| Integration | mcp serve, gateway, relay, remote, notify, voice, clipboard |
Run kcc --help or kcc <command> --help for details; the full help
snapshot lives in kcc_help_out.txt.
docs/SETUP.md— machine setup and operator workflowsdocs/HEADLESS_API.md— headless CLI, MCP tools, and theKCC::protocoldocs/CLI_CHEATSHEET.md— one-page command referencedocs/OPERATOR_SETTINGS.md— workspaces, layouts, slot overridesdocs/RELAY.md— control your fleet from Telegram/WhatsApp via a relay
MIT — see LICENSE. The Koydo name and wordmark are trademarks of Koydo LLC and are not licensed under MIT (see NOTICE).