Skip to content
yicheng47Public

About

Where terminal agents work together. Claude Code, Codex, Copilot CLI and pi on the same task, in one mission, each keeping its own TUI in a real terminal.

Topics

Resources

Contributing

Stars

526 stars

Watchers

1 watching

Forks

Repository files navigation

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 mission workspace — a shared mission feed with @coder handing off to @reviewer alongside live crew session cards

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.

Demo

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

Mobile

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 →

Runner for iOS project overview showing sessions and a nested mission    Runner for iOS mission feed with a crew question awaiting your answer    Runner for iOS live agent terminal with keyboard controls

Features

  • 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_terminal grid, 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 ⇧⌘N or Ctrl+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 runner CLI — Your agents, scripts and terminal can start chats, launch crews and follow missions with the runner command, even with the app closed (--json supported). 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.

Support Runner

If Runner is useful to you, consider supporting its ongoing development and maintenance.

  • Sponsor Runner on Ko-fi — Recommended for international supporters using PayPal.
  • Sponsor Runner on Afdian — 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.
  • 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.

Runner 微信用户群二维码

Supported agents

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 →

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.

About

Where terminal agents work together. Claude Code, Codex, Copilot CLI and pi on the same task, in one mission, each keeping its own TUI in a real terminal.

Topics

Resources

Contributing

Stars

526 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages