An attention-first desktop terminal that runs CLI agents side by side, shows supported agents' latest words and attention state, and returns you to the pane that needs you.
Windows: the 1.0 installer is x64 and unsigned, so Microsoft SmartScreen will warn on first install. Windows 1.0 has shipped without a real-hardware runtime verification pass.
| Launch | Press the quick picker, choose an agent and a worktree, and start it in a real terminal pane. |
| Watch | Read working, asked, and failed states in the Agent Rail. Claude Code, Codex, and OpenCode also expose their latest words. |
| Jump | Select the project or pane that needs intervention instead of hunting through terminal tabs. |
| Resume | Reopen Deck and restore its tabs, workspaces, and the agent conversations each CLI can resolve. |
Resume is exact for Claude Code, Codex, and OpenCode; Gemini CLI and Antigravity are best-effort, while custom agents relaunch their declared command. The implementation is documented in session restore and resume resolution.
Every live project and pane stays visible in one rail. A short status mark distinguishes working, asked, and failed work; supported session logs supply the agent's latest words, and unsupported tails fall back to the agent name (rail model).
Click a worktree card's heading to focus its session and expand or collapse its agents. Clicking the card's empty space focuses it without changing expansion (worktree card). Right-click a worktree and choose Worktree color, or Default to reset its color. The choice stays with that checkout and colors its dot, selected frame and badge (worktree color picker).
Run real PTYs in split panes, move between git worktrees, edit files, and keep browser pages beside terminals as tabs on the same stage. Cmd/Ctrl+click on a path from an agent opens the file and line in a configured editor (PTY host, stage strip).
Drag tabs to rearrange them, or right-click for Pin/Unpin, Close, Close Others and Close to the Right. Pinned tabs stay first with their icon and name; bulk closes skip them. Order and pins last for the current window session; keyboard navigation follows the visible order (tab strip, strip order).
Worktree creation allows up to a minute for checkout. If it is interrupted, Deck checks the branch, destination and worktree registration before reporting whether you can retry or need to inspect the existing checkout. It does not automatically delete or overwrite a partial checkout (worktree creation).
Deck continuously journals open tabs and file surfaces, guards boot restoration against crash loops, and resumes supported conversations without assigning the same session twice (session journal). Pane scrollback and unsaved file edits are not restored.
Recent activity filters its five latest sessions to Unread: questions, warnings and completed results not yet acknowledged in this window. Selecting one opens its pane and acknowledges it; View all opens the complete history (Recent activity).
The usage dashboard reads supported agents' existing local session logs and groups token use and known model costs by agent and day (usage aggregation). It needs no Deck account. Deck sends first-party usage analytics from release 1.1.0 onward — always on, with no opt-out, and no code, file paths or prompts; Settings → Privacy states exactly what is sent (what Deck sends). The receiving service is maintained in backend/; read the public privacy notice for build-specific policy.
Deck includes five agent definitions and accepts user-declared CLI commands. Each agent runs in its own terminal process; Deck coordinates the workspace and attention surface without replacing the CLI's own workflow (agent catalog).
Quick install:
curl -fsSL https://deck.spacevibe.dev/install.sh | shirm https://deck.spacevibe.dev/install.ps1 | iex- macOS — Apple Silicon (arm64): signed and notarized. Intel Macs are not served by V1.
- Windows — x64: unsigned; SmartScreen will warn. Windows ARM is not served, and V1 remains runtime-unverified on Windows hardware.
Deck checks for updates and tells you when one is ready; you choose when to download, install, and relaunch. Both platforms use the moving latest release, never a pinned asset.
Trust: MIT licensed · no Deck account · from 1.1.0, first-party usage analytics always on, with no code, paths or prompts, and no opt-out; Settings → Privacy states what is sent (what Deck sends) · session and usage data read from local agent storage.
- Claude Code:
claude --dangerously-skip-permissions - Codex:
codex --dangerously-bypass-approvals-and-sandbox - OpenCode:
opencode - Antigravity:
agy --dangerously-skip-permissions - Gemini CLI:
gemini --yolo
These are the commands Deck ships, not hidden defaults. Settings lets you disable a built-in, replace its launch command, or add another CLI command.
| Action | macOS | Windows |
|---|---|---|
| Launch an agent | ⌘T |
Ctrl+Shift+T |
| Jump to attention | ⌘⇧A |
Ctrl+Shift+A |
| Next / previous surface | ⌘⇧] / ⌘⇧[ |
Ctrl+Tab / Ctrl+Shift+Tab |
| Split pane | ⌘D / ⌘⇧D |
Ctrl+Shift+D / Ctrl+Alt+Shift+D |
| Toggle file explorer | ⌘⇧B |
Ctrl+Shift+B |
| Open usage | ⌘⇧U |
Ctrl+Shift+U |
| Open Settings | ⌘, |
Ctrl+, |
The complete bindings are listed in keyboard shortcuts and defined in the platform keymaps.
Requires Node.js 20+ and the native build tools required by Electron and node-pty on your
platform.
npm install
npm run electron:devCreate a local packaged macOS build with npm run electron:package. Release packaging is a
separate signed and notarized workflow.
Deck uses Electron, Preact, TypeScript, xterm.js, Monaco Editor, and node-pty. The host and
renderer boundary is mapped in the architecture overview; the full documentation index is docs/README.md, with
user guides under docs/user/ and the build and
release runbooks under docs/operations/.
Focused issues and pull requests are welcome. Please open an issue before starting a substantial product or architecture change, and keep each pull request to one concern. CONTRIBUTING.md says what is likely to be accepted, what needs an issue first, and what a pull request must carry.
MIT © 2026 mxrsv