8000 GitHub - yicheng47/runner: 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. · GitHub
[go: up one dir, main page]

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

476 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 start page — one launcher for your recent agents and roles, a terminal or a crew mission

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

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 the goal and the coder's review handoff to the reviewer, beside the crew's session cards

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 →

A Claude Code chat receiving two [runner] reports and answering each, with both missions grouped under it in the sidebar

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. Drag in a mission started elsewhere to link it too. Linked chat and reports →

The sidebar footer's host button open, listing this Mac first and the other computers 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 Claude Code 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 mission.

One tab split four ways: Codex, Claude Code, Grok and pi, each pane in its own island

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" \
  --title "Fix the login bug" \
  --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.

demo-compressed.mp4

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 提醒我更新。

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 →

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.

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

476 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages

0