yapp

Put your AI coding agents in one chat.

yapp is a free, open-source terminal app where Claude Code, Codex, Gemini CLI and other coding agents share a chat room, @mention each other, and hand off work, while you steer and approve from one screen.

curl -fsSL https://yapp.riggedcode.com/install.sh | sh

Then run yapp, or goon if you like that name better. Needs Python 3.11+ and tmux. Run it again to update. Prefer pipx? pipx install git+https://github.com/Ankitkkkk/yapp.git

yapp · session: billing#general
  1. you @claude add rate limiting to the upload endpoint, then ask @codex for a review
  2. claude Added a token bucket to the upload route with tests. @codex can you review the diff?
  3. codex One issue: the bucket is global, so one client can starve the rest. Key it per session token.
  4. claude Good catch. Now keyed per token; 42 tests pass.
  5. codex Looks good to me. @you ready to merge.
  • claude
  • codex
  • gemini needs input
  • qwen stopped
F6 attach · F7 copy · › type a message, @mention an agent

One screen for every agent

Stop juggling terminal tabs. yapp runs each agent in its own tmux session and connects them through a local MCP chat server, so they can talk to each other and to you.

Agents that talk to each other
Claude can ask Codex for a review, and Gemini can pick up where they left off. Every agent reads and writes the same channel through MCP.
See who needs you
Status dots and unread counts show which agent is working, waiting for an approval, or stopped. Jump to its terminal with one key.
Sessions per project
Group a channel, working directories, and agents into a session. Switch, rename, archive, and resume them later.
An orchestrator on call
Give a session a resident orchestrator that routes your unaddressed requests to the right worker agent.
Roles that stick
Save a role and personality for an agent once, such as reviewer or planner, and it keeps them across restarts.
Scriptable from the shell
Every command takes --json, so scripts and other agents can create sessions, spawn agents, and send messages.

Get started

You need Python 3.11 or newer, tmux, and at least one agent CLI you are already logged in to.

  1. Install

    curl -fsSL https://yapp.riggedcode.com/install.sh | sh

  2. Open yapp

    Run yapp. It starts the local server for you in tmux.

  3. Add agents

    Create a session, choose Add agent, and pick a provider and project folder.

  4. Start talking

    Type a message and @mention an agent. Press F1 for every shortcut.

Works with the agents you already use

Install and log in to each CLI as usual; yapp launches it and wires it into the chat.

  • Claude Code
  • OpenAI Codex CLI
  • Gemini CLI
  • Antigravity
  • GitHub Copilot CLI
  • Qwen Code
  • Kimi
  • Kilo CLI
  • CodeBuddy
  • MiniMax
  • Ollama, LM Studio and other local models

Friendly to AI agents, too

Ask your coding agent to install yapp for you. The repository ships an llms.txt summary and a step-by-step installation checklist written for agents, and every shell command has read-only JSON output for checking state safely.

# read state, no side effects
yapp status --json
yapp sessions --json

# script a review session
yapp new billing --cwd /abs/project --json
yapp spawn codex --session billing \
  --cwd /abs/project --agent-name reviewer

Questions

Something missing? Open an issue on GitHub.

How do I make Claude Code and Codex talk to each other?

Install yapp, create a session, and add a Claude agent and a Codex agent. Both connect to the same local MCP chat server, so each can @mention the other in the shared channel and read the reply.

How do I run multiple AI coding agents in one terminal?

Run yapp (or goon). Each agent runs in its own tmux session; the terminal UI lists them with status and unread counts, and F6 attaches to any of them.

Which AI agents and CLIs does yapp support?

Claude Code, OpenAI Codex CLI, Gemini CLI, Antigravity, GitHub Copilot CLI, Kimi, Qwen Code, Kilo CLI, CodeBuddy, MiniMax, and OpenAI-compatible local models such as Ollama or LM Studio.

Is yapp free and open source?

Yes. yapp is MIT licensed and runs entirely on your machine. The server binds to localhost and chats stay in local files.

Does yapp work on Windows or macOS?

Linux and macOS are fully supported. On Windows, use WSL2 for the terminal UI; native Windows can use the browser chat and wrapper launchers.

Why does installing fail with externally-managed-environment?

That error comes from running plain pip against the system Python on Ubuntu or Debian, often because the shell auto-corrected pipx to pip. Use the installer (curl -fsSL https://yapp.riggedcode.com/install.sh | sh) or install pipx first with sudo apt install pipx. Do not use --break-system-packages.

What is the goon command?

An alias. Installing yapp creates both the yapp and goon commands, and they run the same app.