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
Demo · Mobile · Features · Agents · CLI · Crew example · Community · Contributing
Native macOS (Apple Silicon and Intel) and Windows (x64), with Linux (ARM64, x86_64) in beta.
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.
A tour from first launch: setup finds your agents and builds a starter crew, a mission runs in real terminals and asks you a question, you review the change in the side panel, then follow along from your phone.
0.20.0-overview-github.mp4
Runner for iOS is on public TestFlight: Join on TestFlight →
Use your iPhone to follow live terminals, start chats and missions, and answer your crew on a paired computer.
Requires private beta access: Installing the TestFlight app alone cannot be used yet—signing in and connecting to your computer requires an invited private-beta account, as the relay server is still in private beta (currently available in mainland China only; Tailscale support for users outside mainland China is under development). Join the private beta waitlist on the official website →
- Reusable crews — Compose saved roles into a crew, define shared team conventions, adjust per-slot agent and model overrides, and launch a mission with the same team whenever you need it.
- 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 →
- Missions report back to their chat — A mission started from a chat links to it and groups under it in the sidebar, so the agent can end its turn instead of watching. When the mission needs you, fails or settles, Runner types one line into the chat and the agent reads what happened. Linked chat and reports →
- Remote control — Switch to another computer in the sidebar or connect from your iPhone to use its live terminals, start chats and missions, and answer your crew with end-to-end encryption. Remote control is currently in private beta because the relay server is in private beta for mainland China only; Tailscale support for outside mainland China is in development. Join the beta waitlist → · Remote access guide →
- Real terminals — Each agent keeps its own TUI in a real PTY on a GPU-drawn
alacritty_terminalgrid, with mouse reporting, IME input (Pinyin included), file-path paste and click-to-open, and a shell drawer beneath every mission. - 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
⇧⌘NorCtrl+Shift+N. - Files beside your agents — Read the checkout an agent works in and its git status in the side panel without leaving Runner: highlighted code, rendered Markdown, a file finder on
⇧⌘O, and⌘-click on terminal paths. Files guide → - The
runnerCLI — Your agents, scripts and terminal can start chats, launch crews and follow missions with therunnercommand, even with the app closed (--jsonsupported). Runner installs a skill for detected agents so they can drive it too. CLI guide → - 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 — Runner Light and Runner, plus Catppuccin, Rosé Pine, Tokyo Night, Gruvbox and Solarized, picking a theme for each mode that sets the app and terminal colours together. Claude Code follows the switch live.
If Runner is useful to you, consider supporting its ongoing development and maintenance.
— Recommended for international supporters using PayPal.
— Recommended for supporters in mainland China using WeChat Pay or Alipay.
- Join the Runner Discord for questions, workflows, bug reports and contribution discussions.
- Bugs and feature requests: GitHub Issues.
- Thanks to LINUX DO for providing a community for discussion and sharing open-source projects.
- Scan the QR code below to join the Runner WeChat group for setup help, workflows and feedback. Updated on 2026-11-17; group QR codes expire after 7 days. If it has expired, open an issue so I can refresh it.
First-tier: Claude Code, Codex, Antigravity CLI, Grok Build and pi. Runner is developed and tested against these.
Community-supported: GitHub Copilot CLI, Cursor, OpenCode v2 and TRAE CLI (opt-in). They run chats and missions, and Runner relies on the people who use them to find problems: open an issue when something breaks.
Features and platform support vary by agent.
Agent setup, capabilities and platform notes →
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 →
- GPUI and gpui-pre — 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 — the terminal grid, parser, and scrollback under every pane.
- 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 — Windows builds bundle Microsoft's
conpty.dllandOpenConsole.exeunder the MIT notice (crates/runner-app/LICENSE.conpty). - Catppuccin (MIT), Rosé Pine (MIT), Tokyo Night (Apache-2.0), Gruvbox (MIT) and Solarized (MIT) — bundled app and terminal themes (
crates/runner-app/LICENSE.themes). - Sparkle — the macOS updater.
Runner is written and maintained by Yicheng Wang (Jason Wang, 王逸成) — @yicheng47 on GitHub.
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.




