A multiplexer terminal agent manager, heavily inspired by herdr, powered by Ghostty.

macOS (Apple Silicon) or Linux (amd64):

curl -fsSL https://corgi.computer/install.sh | bash

1. Run corgi in your project directory and choose a shortcut preset.
2. Click New in the agent list to start Claude Code, Codex, Pi or OpenCode.
3. Click an agent or pane to focus it; open the shortcut menu with your prefix, then ? (the default prefix is Ctrl+B).
4. Choose Detach in the shortcut menu to leave processes running.
5. Run corgi again to reconnect.

See the documentation for setup, workspaces and troubleshooting.

curl -fsSL https://corgi.computer/install.sh | bash -s uninstall

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.

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.

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.

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

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.