runner

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

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

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).
• 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.