01 — Terminals
Every pane is a real terminal.
ConPTY, real scrollback, real job objects. Switch panes without losing a line. The terminal is the product surface, not an emulation of one.
A workspace for agent CLIs
Run your agents side by side. See who needs you.
Perch gives every agent a real terminal, one place to see status, and a built-in gateway that connects models to each agent.
02 — Attention
Attention is the interface.
Transcript, hooks and the visible screen have to agree before Perch says an agent is waiting. Collapse the grid and the work board gives every agent one fixed row.
WorkingWaitingIdle
Gateway
Built in, kept separate.
Perch includes a local gateway and applies models per pane. Gateway and provider configuration stay in Perch's own directory, apart from your other agent configuration.
The boundary.
- Other agent configuration — untouched
- Desktop magpie — untouched
- Failed profile — launch stops; no silent fallback
What you can inspect.
- Providers — the accounts and keys you configured
- Routing — how requests reach a provider
- Usage — what each agent has used
- Plugins — magpie plugins, unchanged
PERCH
Agent panes
One real terminal per pane
pane 1Working
pane 2Waiting
pane 3Idle
LOCAL
Built-in gateway
Runs on this machine
ProvidersRoutingUsagePlugins
UPSTREAM
Your providers
Models, keys, quotas
Model listsQuotas
Agents
Nine CLI agents. One workspace.
Install, configure, launch, and resume from the same list. Status depth depends on what each agent exposes.
| Agent | Install | Status | Resume | Notes |
|---|---|---|---|---|
 Claude Code | Official installer | Full | Exact | Hooks; reference adapter. |
 Codex | Official installer | Full | Exact | Per-pane app-server. |
 Pi | npm package | Full | Exact | Observer extension. |
 OpenCode | npm package | Full | Exact | Local HTTP API. |
 Qoder | Official installer | Full | Exact | Claude-shaped hooks; sign-in required. |
 DeepSeek Harness | Community TUI | Full | Exact | Official hook bridge; upstream caveat. |
 Antigravity CLI | Official installer | Full | Exact | Transcript-backed status. |
 Cursor | Official installer | Status only | Exact | Status only; no tool actions. |
 Copilot CLI | Official installer | Full | Exact | Sign in with /login. |
Claude CodeInstallOfficial installer
StatusFull
ResumeExact
Hooks; reference adapter.
Official docs →CodexInstallOfficial installer
StatusFull
ResumeExact
Per-pane app-server.
Official docs →PiInstallnpm package
StatusFull
ResumeExact
Observer extension.
Official docs →OpenCodeInstallnpm package
StatusFull
ResumeExact
Local HTTP API.
Official docs →QoderInstallOfficial installer
StatusFull
ResumeExact
Claude-shaped hooks; sign-in required.
Official docs →DeepSeek HarnessInstallCommunity TUI
StatusFull
ResumeExact
Official hook bridge; upstream caveat.
Official docs →Antigravity CLIInstallOfficial installer
StatusFull
ResumeExact
Transcript-backed status.
Official docs →CursorInstallOfficial installer
StatusStatus only
ResumeExact
Status only; no tool actions.
Official docs →Copilot CLIInstallOfficial installer
StatusFull
ResumeExact
Sign in with /login.
Official docs →Full means Perch can read the agent's own state signals, including tool activity where the agent exposes it. Status only means Perch can show working, waiting, or idle, but not tool actions.
Qoder, Copilot, and Cursor use their own sign-in. DeepSeek Harness tool execution depends on the upstream dsh-tui build.
Desktop and web clients are outside this list. Any client that accepts a custom base URL can use the gateway.
Beta
A single portable executable. No installer, no account, no bundled keys. Unsigned, so SmartScreen may ask. macOS is in development.