Runner MCP Server

<!-- LOGO --> <h1 align="center"> <img src="assets/icon.png" alt="Runner" width="128" /> <br /> Runner </h1> <p align="center"> <a href="https://github.com/yicheng47/runner/stargazers"><img src="https://img.shields.io/github/stars/yicheng47/runner?style=flat-square&logo=github&label=stars" alt="GitHub stars" /></a> <a href="https://github.com/yicheng47/runner/releases"><img src="https://img.shields.io/github/downloads/yicheng47/runner/total?style=flat-square&label=downloads" alt="Downloads" /></a> <a href="./LICENSE"><img src="https://img.shields.io/github/license/yicheng47/runner?style=flat-square&cacheSeconds=86400" alt="License" /></a> <a href="https://discord.gg/6BrfZdHKNf"><img src="https://img.shields.io/badge/Discord-join%20community-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Join Runner on Discord" /></a> <a href="#community"><img src="https://img.shields.io/badge/WeChat-user%20group-07C160?style=flat-square&logo=wechat&logoColor=white" alt="WeChat user group" /></a> <a href="https://runnersh.dev/downloads/"><img src="https://img.shields.io/badge/macOS%20%7C%20Windows-native-2ea44f?style=flat-square" alt="macOS and Windows" /></a> <a href="https://ko-fi.com/yichengwang"><img src="https://img.shields.io/badge/Sponsor-Ko--fi-FF5E5B?style=flat-square" alt="Sponsor Runner on Ko-fi" /></a> </p> <p align="center"> English · <a href="./README.zh-CN.md">简体中文</a> </p> <p align="center"> <strong>Where terminal agents work together.</strong> <br /> 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. </p> <p align="center"> <a href="https://runnersh.dev/"><strong>Official website</strong></a> · <a href="https://runnersh.dev/downloads/"><strong>Download Runner</strong></a> </p> <p align="center"> <img src="assets/hero.png" alt="Runner start page — one launcher for your recent agents and roles, a terminal or a crew mission" width="100%" /> </p> <p align="center"> <a href="#features">Features</a> · <a href="#demo">Demo</a> · <a href="#supported-agents">Agents</a> · <a href="#runner-cli">CLI</a> · <a href="#example-crew">Crew example</a> · <a href="#community">Community</a> · <a href="./CONTRIBUTING.md">Contributing</a> </p>

Alpha · Native macOS (Apple Silicon and Intel) 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 and validation status.

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

<table> <tr> <td width="50%" valign="middle"> <a href="assets/crews.png"><img src="assets/crews.png" alt="Crew detail page with coder and reviewer slots, per-slot overrides and shared team conventions" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Reusable crews</h3> <p>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.</p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/mission_feed.png"><img src="assets/mission_feed.png" alt="A mission feed with the goal and the coder's review handoff to the reviewer, beside the crew's session cards" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Missions and coordination</h3> <p>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. <a href="./docs/arch/arch.md">Architecture →</a></p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/mission-link-reports.png"><img src="assets/mission-link-reports.png" alt="A Claude Code chat receiving two [runner] reports and answering each, with both missions grouped under it in the sidebar" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Missions report back to their chat</h3> <p>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. Drag in a mission started elsewhere to link it too. <a href="./docs/guide/concepts/missions.md#linked-chat-and-reports">Linked chat and reports →</a></p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/remote_control.png"><img src="assets/remote_control.png" alt="The sidebar footer's host button open, listing this Mac first and the other computers on the same account" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Remote control</h3> <p>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. <a href="./docs/guide/guides/remote-access.md">Remote access guide →</a></p> <p><strong>Private beta:</strong> invite-only, currently available in mainland China.</p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/mission_terminal.png"><img src="assets/mission_terminal.png" alt="A mission slot's own terminal: the coder's Claude Code session, beside the crew's session cards" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Real terminals</h3> <p>Each agent keeps its own TUI in a real PTY on a GPU-drawn <code>alacritty_terminal</code> grid, with mouse reporting, IME input (Pinyin included), file-path paste and click-to-open, and a shell drawer beneath every mission.</p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/chat_split.png"><img src="assets/chat_split.png" alt="One tab split four ways: Codex, Claude Code, Grok and pi, each pane in its own island" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Split tabs and windows</h3> <p>Split a tab as far as the window allows, drag panes to reorder, group tabs into folders, and open more windows with <code>⇧⌘N</code> or <code>Ctrl+Shift+N</code>.</p> </td> </tr> <tr> <td width="50%" valign="middle"> <a href="assets/files_view.png"><img src="assets/files_view.png" alt="A Claude Code chat beside the side panel's Files view: the worktree's tree with its git status and a file open in a tab" width="100%" /></a> </td> <td width="50%" valign="middle"> <h3>Files beside your agents</h3> <p>The side panel's Files view shows the checkout an agent works in, with its git status, so you can read what changed without leaving Runner: highlighted code, rendered Markdown and a file finder on <code>⇧⌘O</code>. ⌘-click a path in a terminal to open it at that line. Files stay read-only; editing stays with your agent and editor. <a href="./docs/guide/guides/chats-and-windows.md#browse-files-in-the-side-panel">Files guide →</a></p> </td> </tr> <tr> <td width="50%" valign="middle"> <pre><code>runner crew list runner mission start \ --crew "Pair coding crew" \ --title "Fix the login bug" \ --goal-file brief.md runner mission feed &lt;mission-id&gt; --follow runner help agents</code></pre> </td> <td width="50%" valign="middle"> <a name="runner-cli"></a> <h3>The <code>runner</code> CLI</h3> <p>Your agents, scripts and terminal can start chats, launch crews and follow missions with the <code>runner</code> command, even with the app closed. Add <code>--json</code> for machine-readable output. Runner installs a skill for detected agents so they can drive it too. <a href="./docs/guide/guides/drive-runner-from-agents.md">CLI guide →</a></p> </td> </tr> </table>

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 — 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.

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.

• — Recommended for international supporters using PayPal.
• — Recommended for supporters in mainland China using WeChat Pay or Alipay.

Community

• 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.
• 中文用户可以扫码加入 Runner 微信用户群。群二维码 7 天过期，如果扫码提示失效，请提一个 issue 提醒我更新。

<img src="assets/wechat_group_qr.png" alt="Runner 微信用户群二维码" width="200" />

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 →

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 →

Acknowledgements

• 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.dll and OpenConsole.exe under 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.

Author

Runner is written and maintained by Yicheng Wang (Jason Wang, 王逸成) — @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.