A multiplexer terminal agent manager, heavily inspired by herdr, powered by Ghostty.
Install
macOS (Apple Silicon) or Linux (amd64 or arm64):
curl -fsSL https://corgi.computer/install.sh | bash
First session
- Run
corgiin your project directory and choose a shortcut preset. - Click New in the agent list to start Claude Code, Codex, Pi or OpenCode.
- Click an agent or pane to focus it; open the shortcut menu with your prefix,
then
?(the default prefix is Ctrl+B). - Choose Detach in the shortcut menu to leave processes running.
- Run
corgiagain to reconnect.
See the documentation for setup, workspaces and troubleshooting.
Uninstall
curl -fsSL https://corgi.computer/install.sh | bash -s uninstall
Agents
Run claude, codex, pi or opencode in any pane. Corgi notices them and
adds its hooks to their settings; Pi gets an extension, and OpenCode needs
nothing. Codex asks you to trust the hooks once, in /hooks.
| Claude Code | Codex | Pi | OpenCode | |
|---|---|---|---|---|
| Status: ▶ working ● needs you ● done | ✓ | ✓ | ✓ | ✓ |
| Activity summaries | ✓ | ✓ | ✓ | ✓ |
| Subagents | ✓ | ✓ | ✓ | |
| Context, tokens and rate limits | ✓ | ✓ | ✓ | ✓ |
| Rename and fork | ✓ | ✓ | ✓ | ✓ |
| Resume after a crash or reboot | ✓ | ✓ | ✓ | ✓ |
| Multi accounts | ✓ | ✓ | ✓ |
Scripting
corgi controls the running session from any shell. Commands print text
(--json for JSON), take IDs from corgi list, and accept current for the
pane they run in.
corgi list
corgi tab new --workspace 1 --command 'bun run dev'
corgi pane split current --right --command codex
corgi pane send 3 'run the tests' --enter
corgi pane read 3 --lines 50
corgi --help lists every command. Agents in a pane can run corgi --skill to
learn the interface.
Development
Needs Bun and the pinned Zig toolchain.
./go.ts
go.ts builds and attaches, reloading changed builds while preserving panes.
See HACKING.md for the development workflow and architecture.
Acknowledgements
- Ghostty and Kitty: for their pioneering work on computer terminals, and for providing such a strong foundation.
- herdr: Corgi's main inspiration. We borrow many of their ideas.
- Pi: we use its pi-tui library.
- Bun: enabled Corgi to be written in TypeScript.
Special thanks to our early testers for their wonderful suggestions and feedback: Max Bittker, Aaron Blakeman, Kai Johnson, Luke Alonso and Keith Adams.
License
Corgi is released under the MIT License.
The notification sounds in assets/sounds/ come unchanged
from herdr and stay under herdr's
Apache License 2.0; see
their README.
corgi licenses prints these together with the licenses of the other
software Corgi includes, listed in assets/licenses.txt.
