Open source · MIT

The control plane for the coding agents you already use.

Codey is a multi-agent workbench. Orchestrate Claude Code, OpenCode, and Codex across your projects — from a macOS app, your favorite chat platform, or system-wide voice. It's not a chat bridge. It's command central.

3coding agents
5surfaces to drive it
100%your machine, your keys
What is Codey?

One place to point every coding agent you own at the work in front of you.

Most agent tools lock you into one CLI and one window. Codey sits above them — routing prompts to Claude Code, OpenCode, or Codex, isolating each project in its own workspace, and letting you spin up whole teams of agents that pass work between each other. Reach it from your phone, your menu bar, or just by holding a key and talking.

macOS app

A native menu-bar app to drive it all.

Chat platforms

Telegram, Discord & iMessage.

Voice

Hold a key, speak, done — on-device.

Terminal UI

A keyboard-first TUI for the shell.

Features

Everything you need to run agents like a team.

Codey turns a pile of separate CLIs into a coordinated workbench — with isolation, memory, and orchestration built in.

Multi-agent routing

Switch between Claude Code, OpenCode, and Codex per workspace — each with its own model, from Opus to GPT-5-Codex. One command moves the whole conversation.

Worker teams

Define workers in markdown — each with a role, tools, and agent. Run them solo, sequentially, or as a manager-moderated roundtable that talks to itself.

Parallel execution

Fire one prompt at every agent at once with /parallel and compare answers side by side. Pick the best, or let them race.

Workspaces & memory

Every project gets its own working directory, persistent memory.md, and worker roster. Switch context without losing your place.

On-device voice

Hold a hotkey, speak, release. WhisperKit transcribes on the Neural Engine — no API key, no upload — and types straight into the focused app.

Health & monitoring

Built-in /health, /metrics, and /ready endpoints, per-user rate limiting, and auto-chunked responses keep the gateway production-ready.

Commands

Slash commands, anywhere you type.

The same vocabulary works in every channel — chat, app, or TUI.

/team <task>Run a team of workers, sequentially or auto-dispatched
/worker <name> <task>Run a single named worker on a task
/parallel <prompt>Run all agents at once and compare
/agent <name>Switch the active coding agent
/workspace <name>Switch to another project workspace
/workspacesList every workspace you've set up
/model <name>Show or set the model for the agent
/statusGateway status & channel connectivity
/clearClear the current conversation history
/helpShow the full command reference
Quick start

Up and running in four commands.

Clone the repo, configure your keys, and start the gateway. That's it.

  1. Install

    Pull dependencies across the monorepo.

  2. Build

    Compile TypeScript and the macOS app.

  3. Configure

    Add agents, models, and channel tokens interactively.

  4. Start

    Launch the gateway and connect your channels.

~/codey
# clone & install
git clone https://github.com/its-ahoh/codey.git
cd codey && npm install

# build everything
npm run build

# set up agents, models & channels
cp gateway.json.example gateway.json
npm run configure

# launch the gateway
npm start

Get the macOS app

Native menu-bar app with built-in voice. Grab the latest DMG for your chip.

Builds are unsigned — on first launch, right-click the app and choose Open to bypass Gatekeeper.