Multi-session Claude Code orchestrator for macOS.
Run multiple Claude Code sessions in parallel, organized by workspace and git branch. For developers who need to keep multiple agentic conversations alive without context loss.
Beta software. Expect rough edges. File issues on GitHub.
Screenshot pending — add
docs/screenshots/main-interface.pngbefore publishing.
- Parallel sessions, no context loss. Run executor and exploratory sessions simultaneously without killing conversations.
- Workspace isolation. Each project gets its own workspace — sessions, config, and branch context stay separate.
- Branch-aware workflow. Switch branches without leaving the app. Cmd+Shift+B opens a searchable switcher across local branches.
- Hooks surface to the UI. Claude Code hook events (task done, error) reach Deck as notifications — no terminal-watching required.
- Multi-type sessions: Claude Code and shell, per workspace
- Workspace organization with sidebar navigation
- Branch switcher with search (Cmd+Shift+B)
- Open in IDE: right-click workspace → open in Zed, Cursor, VS Code, or Fork
- Hook notifications for Claude Code state changes (working, done, error)
- Command palette (Cmd+P)
- macOS-native keyboard shortcuts throughout
- Native xterm.js terminal with full PTY support
- Download the
.dmgfrom Releases - Open the
.dmgand drag Deck.app to/Applications - On first launch, macOS will block the app (unsigned binary). Run:
xattr -cr /Applications/Deck.app
- Open Deck normally after running the command above
Deck is not signed with an Apple Developer ID. The
xattrcommand removes the Gatekeeper quarantine flag — this is a one-time step.
git clone https://github.com/dougss/deck.git
cd deck
pnpm installDevelopment:
pnpm devProduction build:
pnpm build:mac
# Output: dist/Deck-<version>.dmgRequires Node.js 22 LTS and pnpm.
- Open Deck — a default workspace is created on first launch
- Click + New session → choose Claude Code or Shell
- Configure the session: name, working directory, and (for Claude Code) the command
- Open additional sessions with Cmd+N or via Cmd+P → "New Claude Code session"
- Navigate between sessions using the shortcuts below
| Shortcut | Action |
|---|---|
| Cmd+N | New session |
| Cmd+W | Close session |
| Cmd+1–9 | Switch to session by index |
| Cmd+F | Search sessions in sidebar |
| Cmd+P | Command palette |
| Cmd+Shift+B | Branch switcher |
| Cmd+Q | Quit |
Electron 39 with a standard multi-process architecture. The main process (Node.js) handles PTY management via node-pty, SQLite persistence via better-sqlite3, and IPC routing. A preload script exposes a typed window.deck API to the renderer. The renderer is a React 19 + TypeScript SPA styled with Tailwind CSS v4. Terminal emulation uses xterm.js. Client state is managed with Zustand.
src/
main/ Electron main process — PTY, SQLite, IPC handlers
preload/ IPC bridge — exposes window.deck API to the renderer
renderer/ React UI — components, stores, hooks
shared/ Types and IPC channel constants
scripts/ Build and install helpers
docs/ Architecture docs, phase plans, design references
- Branch switcher: remote branch listing and checkout
- Planner panel: read-only Claude Code session for architecture and planning, embedded in a right sidebar
- More session types: Codex CLI, Gemini CLI alongside Claude Code
- Settings: expanded customization — editor preferences, keyboard shortcuts, appearance
No dates. These are planned, not promised.
- macOS only. Intel (x64) native. Apple Silicon supported via Rosetta 2. No Windows or Linux support planned.
- Unsigned binary. Distributing a signed app requires an Apple Developer ID ($99/year). A Gatekeeper workaround (
xattr -cr) is required on first launch. - Single-user. No multi-user collaboration or remote session sharing.
- Requires Claude Code. Deck orchestrates the
claudeCLI — it does not bundle it. Install and authenticate Claude Code separately.
Issues and pull requests are welcome. No formal contribution process yet.
- Bug reports and feature requests
- For larger changes, open an issue to discuss before sending a PR
MIT — see LICENSE file.
- Anthropic Claude Code — the agent this app orchestrates
- Open-source dependencies:
xterm.js,node-pty,better-sqlite3,electron, React, Tailwind CSS, and the full list inpackage.json - Design inspiration: Warp, Wave Terminal, Linear, Raycast