Languages: English | 简体中文
Run all your coding agents from one terminal — and pick them up from your phone.
Claude Code, Codex, OpenCode, Cursor, and Pi side by side. See which agent needs you, open several sessions together, and keep hosted agents running when you close the workspace.
One sidebar for your agents. Read a conversation or open sessions side by side.
| Part | What it does | Status |
|---|---|---|
| Terminal app | Run, watch, and switch between all your coding agents in one terminal. | Available — install below |
| Mac and iPhone app | Follow your agents and answer them away from the terminal. | Mac: signed download · iPhone: self-build with Xcode |
| Relay | Connect your host and clients across networks. | Self-hosted · AGPL-3.0-only |
| 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.
Upgrade with brew update && brew upgrade x0c/tap/corral. The formula uses prebuilt wheels for Corral and its Python dependencies.
Without Homebrew
Install Python 3.10+ and tmux 3.2+, then run:
curl -fsSL https://raw.githubusercontent.com/corral-dev/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 or Mac. Read replies, send a follow-up, or answer a question away from the terminal with the native app; see below.
- Find past conversations. Combine Active, runtime and project quick filters with title filtering, or search what you said across every assistant's history. Quick filters narrow the sidebar while keeping your open panes in place.
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 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
The native app shows the same sessions as the terminal: read conversations side by side, send a follow-up, or answer a question without opening a terminal.
- Mac: download the signed app (macOS 26+). It updates itself.
- iPhone: build from source with Xcode. A public App Store or TestFlight download is not available yet.
Installing the CLI does not install the app. With the app installed, run this on the machine hosting your agents:
corral remote pairPairing starts remote access and installs any missing remote components. Scan or paste the code in the app on the same local network. Away from home, you need a relay you host yourself; Corral does not bundle a shared public relay. Remote traffic is end-to-end encrypted. For access across networks, follow the relay setup. Use corral remote pair --readonly when a device should only view sessions.
- 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 device 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
- Contributing — development and pull requests
- 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 fits your workflow, star the repository to find it again.