Languages: English | 简体中文
Run all your coding agents from one terminal — and pick them up from your phone.
Claude Code, Codex, Cursor, OpenCode, Kimi Code, and Pi side by side. They keep running when you step away, and you can see which one is waiting for you.
Captured from the real terminal UI with sample conversations — not a recording of your machine.
| Part | What it does | Status |
|---|---|---|
| Terminal app | Run, watch, and switch between all your coding agents in one terminal. | Available — install below |
| iPhone and Mac app | Follow your agents and answer them away from the terminal. | iPhone: in development, no public download · Mac: planned |
| Corral Ideas | Jot loose ideas on one local page; a coordinating agent turns them into tasks and hands them to coding agents. | Planned |
On macOS or Linux with Homebrew:
brew install x0c/tap/corral
corralUse the full tap name: brew install corral installs an unrelated project. Homebrew installs Python and tmux for you.
Without Homebrew
Install Python 3.10+ and tmux 3.2+, then run:
curl -fsSL https://raw.githubusercontent.com/x0c/corral/main/install.sh | bash
corralFollow the installer's PATH instructions if your terminal cannot find corral. A source-build fallback requires Rust.
Install and sign in to at least one supported coding assistant separately. Corral is free and MIT-licensed; the assistants use their own accounts and may incur charges. Windows and WSL are not supported.
- See who needs you. Working agents and agents waiting on your answer show up in one sidebar, across every assistant.
- Work side by side. Open up to four sessions together, group related work, and pin what matters.
- Keep agents running. Hosted sessions keep going after you close Corral or disconnect SSH, as long as the host stays awake.
- Hand work to another assistant. Pass a task with its conversation history to a new session in a different assistant — for example, Claude implements and Codex reviews.
- Continue from your phone. Read replies, send a follow-up, or answer a question away from your desk. The iPhone app is still in development; see below.
- Find past conversations. Search what you said across every assistant's history, or filter by project and title.
Open corral. Existing assistant sessions appear in the sidebar. Selecting a conversation reads it; it does not start that assistant. Press Enter to resume an ended session or attach to a hosted terminal.
Press Ctrl+N to start something new. From your shell you can also choose the assistant:
corral claude
# Also: corral codex | corral opencode | corral kimi | corral cursor | corral piSelect two to four sessions with Space, then press Enter to open them side by side. Closing a pane hides that view; it does not stop a hosted agent.
To continue elsewhere, open a session, press Ctrl+T, and choose an assistant. After Claude finishes an implementation, you can hand that conversation to Codex for review. The source session stays intact; the receiving assistant reads the history it needs. Press Enter instead when you want the original assistant's native resume.
Press Ctrl+\ to return keyboard control to the sidebar. Quitting Corral leaves hosted agents running.
Corral launches supported assistants with their automatic-approval modes enabled where available. Those agents can act with your local user permissions.
| Key | Action |
|---|---|
/ |
Filter projects and session titles |
Ctrl+F |
Search conversation text |
Enter |
Resume or enter the selected session |
Ctrl+N |
Start a new session |
Space, then Enter |
Select two to four sessions and split the view |
Ctrl+T |
Export, copy, or hand off a session |
Ctrl+\ |
Return input to the sidebar |
Esc |
Close the current dialog or quit |
Sidebar shortcuts apply while the sidebar has focus. The footer shows actions available in the current view.
Search by what you said
Leave the desk and keep your agents moving: read conversations, send a follow-up, or answer a question from your iPhone.
The iPhone app is still in development; this repository does not provide a public app download. Installing the CLI does not install the companion app.
With a companion build and the remote dependencies installed on your host:
corral remote on
corral remote pairPair on the same local network. Away from home, you need a relay you host yourself; Corral does not bundle a shared public relay. Phone traffic is end-to-end encrypted. See the remote setup guide for pairing and relay configuration.
- Session browsing and search read local assistant history.
- Optional title generation may send short excerpts to a configured language-model gateway and can consume quota there.
- Update checks contact GitHub.
- Pairing a phone authorizes it to access and act on your sessions; remote traffic is end-to-end encrypted.
See the privacy policy for data flows and controls.
corral list --top 10 --compact
corral search "login" --deep
corral show <session-id-prefix> --messages 10 --compactSee the command reference for JSON output, export, and handoff planning.
- Command reference — CLI usage and automation
- Terminal guide — panes, groups, focus, and shortcuts
- Remote guide — phone pairing and self-hosted access
- Maintainer guide — development, testing, and releases
- Report a bug or suggest an improvement — include your OS, terminal, Corral version, and steps to reproduce. Remove private conversation content from reports.
If Corral belongs in your daily workflow, a star helps other developers discover it.