Runner
Runner

GitHub stars Downloads License Join Runner on Discord WeChat user group macOS and Windows Sponsor Runner on Ko-fi

English · 简体中文

Where terminal agents work together.
Claude Code, Codex, Antigravity CLI, Copilot CLI and pi on the same task, in one mission. Each agent keeps its own TUI in a real terminal; Runner is what sits between them.

Official website · Download Runner

Runner start screen — start a new chat, terminal or crew mission from one workspace

Features · Demo · Agents · CLI · Crew example · Community · Contributing

> Alpha · Native macOS (Apple Silicon) and Windows (x64), with Linux (ARM64, x86_64) in beta. Linux support is in beta from Runner 0.18.2, with signed `.deb` and tarball packages for ARM64 and x86_64 and in-app updates. It has been tried on an Ubuntu 26.04 ARM64 virtual machine; native hardware, x86_64 and other distributions are not yet verified. See [Linux build and install instructions](docs/arch/linux.md) and [validation status](docs/tests/823-linux-support.md). Runner brings CLI coding agents together in reusable crews, with real terminals and a shared mission feed. Your sessions and history stay on your machine. ## Features
Crew detail page with coder and reviewer slots, per-slot overrides and shared team conventions

Reusable crews

Compose saved roles into a crew and define shared team conventions. Review each slot's agent and model, adjust overrides, then launch a mission with the same team whenever you need it.
A mission feed with coder, reviewer and QA coordinating, and a question waiting for your input

Missions and coordination

Each mission gives every crew slot a live terminal and a shared feed where agents coordinate and bring questions to you. Stop, resume or restart one slot without touching the rest. Architecture →
Runner's computer picker listing this Mac and another computer on the same account

Remote control

Pick another computer in the sidebar to use its live terminals, start chats and missions, and answer your crew. Connections are encrypted end to end. Remote access guide →

Private beta: invite-only, currently available in mainland China.
A mission slot's own terminal: the coder's Codex session, beside the crew's session cards

Real terminals

Each agent keeps its own TUI in a real PTY on a GPU-drawn alacritty_terminal grid, with mouse reporting, IME input (Pinyin included), file-path paste and click-to-open, and a shell drawer beneath every chat and mission.
One tab split four ways: Codex, Claude Code, Antigravity CLI and pi side by side

Split tabs and windows

Split a tab as far as the window allows, drag panes to reorder, group tabs into folders, and open more windows with ⇧⌘N or Ctrl+Shift+N.

 
runner crew list
runner mission start \
  --crew "Pair coding crew" \
  --goal-file brief.md
runner mission feed <mission-id> --follow
runner help agents

The runner CLI

Your agents, scripts and terminal can start chats, launch crews and follow missions with the runner command, even with the app closed. Add --json for machine-readable output. Runner installs a skill for detected agents so they can drive it too. CLI guide →
**Also included:** - **Agents keep working when Runner is closed** — Sessions live in `runnerd`, Runner's background service. Quit the app, or let it crash, and reopen it to the same live terminals; stopped agents resume their own conversations on the next launch. - **MCP servers and skills in one place** — **Settings → MCP** and **Settings → Skills** list each agent's own config and switch entries off per agent, changing only the entry you touched. - **Desktop notifications** — Get notified when an agent needs input, finishes a turn or fails, and click to open its chat or mission. Choose events in **Settings → Notifications**. - **Projects** — Bind a working directory once; chats and missions started in it inherit the cwd and group in the sidebar. - **Light and dark** — Carbon and Runner Light, plus Catppuccin, with an app palette and a terminal palette per mode. Claude Code follows the switch live. ## Demo A quick tour of reusable roles, crew setup, split terminals, and coder/reviewer/QA coordination in a live mission. https://github.com/user-attachments/assets/c2209015-1497-403a-98bd-cdc5502bee47 ## Support Runner If Runner is useful to you, consider supporting its ongoing development and maintenance. - [![Sponsor Runner on Ko-fi](https://img.shields.io/badge/Sponsor%20Runner-Ko--fi-FF5E5B?style=for-the-badge)](https://ko-fi.com/yichengwang) — Recommended for international supporters using PayPal. - [![Sponsor Runner on Afdian](https://img.shields.io/badge/Sponsor%20Runner-Afdian-946BE7?style=for-the-badge)](https://afdian.com/a/runnersh) — Recommended for supporters in mainland China using WeChat Pay or Alipay. ## Community - Join the [Runner Discord](https://discord.gg/6BrfZdHKNf) for questions, workflows, bug reports and contribution discussions. - Bugs and feature requests: [GitHub Issues](https://github.com/yicheng47/runner/issues). - Thanks to [LINUX DO](https://linux.do) for providing a community for discussion and sharing open-source projects. - 中文用户可以扫码加入 Runner 微信用户群。群二维码 7 天过期，如果扫码提示失效，请[提一个 issue](https://github.com/yicheng47/runner/issues/new) 提醒我更新。 Runner 微信用户群二维码 ## Supported agents Runner integrates with **Codex, Claude Code, Antigravity CLI, GitHub Copilot CLI, pi, Cursor, Grok Build and OpenCode v2**. **TRAE CLI** is available as an opt-in runtime. Features and platform support vary by agent. [Agent setup, capabilities and platform notes →](./docs/guide/reference/supported-agents.md) ## Example crew Fresh installations include **Pair coding crew**: a coder implements and a reviewer checks the diff until the review is clean. Both use Codex by default; you can choose a different agent for either role. [Build a crew and explore example prompts →](./docs/guide/guides/build-a-crew.md) ## Acknowledgements - **[GPUI](https://github.com/zed-industries/zed/tree/main/crates/gpui)** and **[gpui-pre](https://github.com/longbridge/gpui-kit)** — the UI uses a crates.io snapshot of Zed's GPU-accelerated UI framework. Thank you to the Zed team for building and open-sourcing GPUI, and to gpui-kit and Jason Lee (huacnlee) for publishing gpui-pre; Zed's terminal crates were the architectural reference for Runner's terminal split. - **[alacritty_terminal](https://github.com/alacritty/alacritty)** — the terminal grid, parser, and scrollback under every pane. - **[xterm.js](https://github.com/xtermjs/xterm.js)** — the procedural box-drawing glyph table is transcribed from the WebGL addon under its MIT notice (`crates/runner-app/LICENSE.xterm`). - **[Windows Terminal ConPTY](https://github.com/microsoft/terminal)** — Windows builds bundle Microsoft's `conpty.dll` and `OpenConsole.exe` under the MIT notice (`crates/runner-app/LICENSE.conpty`). - **[Sparkle](https://sparkle-project.org)** — the macOS updater. ## Author Runner is written and maintained by **Yicheng Wang** (Jason Wang, 王逸成) — [@yicheng47](https://github.com/yicheng47) on GitHub. ## License MIT. Copyright (c) 2026 Yicheng Wang (Jason Wang). You can use, modify, and redistribute Runner for anything, including at work and inside closed-source products, as long as you keep the copyright notice (see `LICENSE`). Versions released from 2026-08-22 through 2026-09-22 were published under GPL-3.0-only and remain available under that license.