Everything you need to run AgentDeck

Windows 10 or 11, 64-bit. One download, no runtime to set up.

1. 1

   Download

   Grab the Windows installer (AgentDeck-win-Setup.exe) or the portable ZIP from the download button.

2. 2

   Run it

   The installer sets AgentDeck up per-user — no admin prompt — and turns on one-click updates. The portable ZIP runs from any folder with no install, but you update it by hand.

3. 3

   Get past SmartScreen

   The builds aren’t code-signed yet, so Windows shows “Windows protected your PC”. Click More info → Run anyway. You only do this once.

Apple Silicon Macs (M1 or newer) running macOS 12 or later. Intel Macs aren’t supported.

1. 1

   Download

   Grab the macOS installer (AgentDeck-osx-Setup.pkg) from the download button, or the portable AgentDeck-osx-Portable.zip if you’d rather not run an installer.

2. 2

   Install it

   Open the .pkg and follow the steps. With the ZIP, unzip it and drag AgentDeck.app into your Applications folder.

3. 3

   Get past Gatekeeper

   The Mac build isn’t signed with an Apple Developer ID yet, so macOS says Apple “could not verify” AgentDeck. Click Done, open System Settings → Privacy & Security, scroll to the AgentDeck message, click Open Anyway and confirm with your password. You only do this once (it can appear for the installer and again for the app).

4. 4

   Or clear it from Terminal

   Already installed? xattr -dr com.apple.quarantine /Applications/AgentDeck.app removes the quarantine flag in one go. To check the download, compare shasum -a 256 AgentDeck-osx-Setup.pkg with SHA256SUMS-mac.txt on the release.

5. 5

   Allow the microphone (for voice)

   Voice input works on the Mac: press F5 (fn + F5 on Apple keyboards) or click the mic button. Allow microphone access when macOS asks; if you refused it, AgentDeck offers to open System Settings → Privacy & Security → Microphone for you.

6. 6

   Shortcuts use ⌘

   Wherever this manual says Ctrl, press ⌘ Cmd on a Mac — Ctrl + Shift + P is ⌘ + Shift + P, Ctrl + B is ⌘ + B.

64-bit Linux desktops. Everything works except voice input, which isn’t available on Linux yet.

1. 1

   Download

   Grab AgentDeck-Linux-Install.sh from the download button.

2. 2

   Run it

   Run bash AgentDeck-Linux-Install.sh — it unpacks the app and adds AgentDeck to your app launcher. No chmod needed.

3. 3

   Or run the AppImage

   Prefer a portable executable? Download AgentDeck.AppImage, then chmod +x AgentDeck.AppImage && ./AgentDeck.AppImage.

AgentDeck needs a free account. Sign in with Google when the login window appears. New accounts get a 7-day trial of every Pro feature; after that you continue on the free tier (1 workspace, up to 4 panes) or an active Pro plan. Signing in only syncs your preferences — never your shells, agents or keys.

The first launch walks you through three steps. You can reopen it any time from the toolbar.

1. 1

   Start — pick a folder

   Point the first workspace at a project folder. Recent folders are remembered for next time.

2. 2

   Layout — choose your panes

   Pick how many terminal panes you want and whether they sit in a grid, columns or rows. Splitters are drag-to-resize afterwards.

3. 3

   Agent — choose a coding agent

   Claude Code, Codex, Copilot CLI, Gemini, Cursor Agent, opencode and six more. If one isn’t installed, AgentDeck shows the exact install command, a guide link and a Re-check button that re-reads your PATH — no restart.

1. 1

   Every pane is a real terminal

   Native Windows ConPTY — run anything, not just the agent. vim, less and full-screen TUIs all work. Ctrl+Shift+T adds a plain shell pane in the same folder.

2. 2

   Switch without losing work

   Workspaces keep running in the background. A workspace’s sidebar row shows a green dot while an agent in it is working.

3. 3

   Add a workspace

   The + in the sidebar (or Ctrl+Shift+N) opens a new workspace with its own folder and agent. A second workspace is a Pro feature.

4. 4

   Drag files in

   Drop a file from Explorer onto a pane to paste its quoted path at the prompt.

5. 5

   Size panes your way

   Every divider moves only the panes on either side of it. Ctrl+Alt+→ / ↓ splits the active pane; Ctrl+Shift+0 evens them out. Your arrangement survives adding and closing panes — and a restart.

6. 6

   Move a pane to another workspace

   Drag a pane by its header onto another workspace in the sidebar, or right-click the header → Move to workspace. Its shell, agent and scrollback keep running.

7. 7

   Folders in the sidebar

   The Folders section under your workspaces shows the working folder and any you pin. Drag a folder onto a pane to type its path, search with the magnifier (paths work too), or right-click for “New terminal here”. Double-click a file to preview it (Markdown, code, images, PDF, Word), and cut, copy and paste with Ctrl+X / C / V — it works with File Explorer both ways and never overwrites.

8. 8

   Know which pane needs you

   When an agent in a pane you’re not looking at stops to ask a question, finishes or crashes, its workspace dot changes colour and AgentDeck flashes the taskbar. Turn on desktop toasts in Settings → Notifications; clicking one opens that exact pane.

9. 9

   Pick up where you left off

   Close AgentDeck and it remembers your workspaces, folders, agents and pane layout, then reopens them on the next launch.

10. 10

    Restart a pane

    The ↻ icon in a pane header restarts that agent and re-runs its startup command. Ctrl+Shift+R force-recovers a pane left frozen by a crashed full-screen program.

Press Ctrl+Shift+X (F5 on macOS) and talk. A floating overlay transcribes your speech on-device with whisper.cpp and types it at the active prompt — no Enter is sent. Press Enter in the pane to end dictation. The small English model (~75 MB) downloads on first use. Nothing audio-related leaves your machine. Voice input is a Pro feature, available on Windows and macOS.

The ⤳ button in a pane header carries that agent’s current conversation into a new pane in the same workspace. Hand it back to the same agent to keep going with full history, or to a different agent or model to get a second take. Conversation handoff is a Pro feature.

1. 1

   Press ⤳ on the pane

   AgentDeck detects the agent running in the pane and opens the handoff dialog. The source folder defaults to the folder the pane opened in — edit it if the conversation moved.

2. 2

   Choose where it goes

   Pick the target agent. Same agent → a native resume (claude --resume, codex resume, opencode --session, goose --resume); tick “Fork the session” to leave this pane untouched. Different agent → AgentDeck writes the conversation to a Markdown file under .agentdeck/ in the folder (kept out of git) and starts the new agent on it. Optionally include the agent’s own thinking.

3. 3

   Work continues in the new pane

   A new pane opens running the target agent. For a resume it picks up mid-conversation; for a cross-agent transcript the opening prompt is seeded for you — read it and press Enter.

Run several agents on one repository without them touching each other’s files — or your checkout. Isolated worktrees are a Pro feature.

1. 1

   Open an isolated workspace

   In the New Workspace dialog, tick “Isolate each terminal in its own git worktree”. Every pane gets its own worktree on a throwaway agentdeck/… branch.

2. 2

   Review the work

   The Worktrees page in the sidebar lists each one with its files, line counts and the full diff.

3. 3

   Keep it or bin it

   Merge to base, rebase onto base, open a pull request, open it in a pane — or discard it. Closing a workspace settles its worktrees too.

A routine is a scheduled agent prompt: “every weekday at 9:00, open Claude and review my open PRs”. Pick the prompt, the agent, a workspace (or a new one), the time and the days. Routines fire while AgentDeck is open; for a time that passes while it’s closed you choose what happens — Notify me, Skip quietly or Run latest. “Run now” fires one on the spot. Run history records every run as launched, working, needs review, done, failed or interrupted, with its output, and lets you jump to the terminal, mark it done or retry it. Routines are a Pro feature.

A skill is a reusable SKILL.md instruction — “write the failing test first”, “use conventional commits” — that AgentDeck wires into every agent: Claude Code discovers it natively, the others read it through AGENTS.md. Skills are a Pro feature and sync across your devices.

1. 1

   Start from the library

   Browse skill library… offers 28 ready-made skills — diff review, commit messages, PR descriptions, debugging, tests, API design, database migrations, Docker, CI fixes and more, plus a Security set: secrets scan, threat model, auth review, input validation, dependency audit, web and CI/CD hardening. Add one, or add them all.

2. 2

   Write or upload your own

   New skill opens an editor; Upload imports an existing SKILL.md. Every skill is yours to edit afterwards — edits you make to its file on disk show up too (↻ Refresh).

3. 3

   Improve with an agent

   Improve with agent opens a pane where the agent of your choice reviews the skill and rewrites it; AgentDeck picks up its edits automatically.

Click Browser in the Agents panel header (or press Ctrl+Shift+O) and a browser takes that panel’s place at the same width, so your terminals don’t move. Use tabs and DevTools (F12), press F11 to fill the window, or ⧉ to send the page to your normal browser. Dev servers your panes are running appear as one-click buttons. Ctrl+click a link in any terminal to open it here; Ctrl+Shift+click uses your normal browser.

Connect GitHub, Vercel, Jira, GitLab, Linear, Supabase, Google Drive or LinkedIn from the Plugins tab at the bottom of the sidebar, then restart the agent (↻) once so it picks up the new tools. For the hosted ones, run “/mcp” in the pane afterwards to finish signing in. Plugins are a Pro feature.

1. 1

   Theme & colour scheme

   System, light or dark, in any of 25 colour schemes — Catppuccin, Dracula, Nord, Tokyo Night, Gruvbox, Rosé Pine, Night Owl, Cyberpunk, Matrix and more. The sun/moon button in the toolbar toggles light and dark; the gear opens full Settings.

2. 2

   Glass window styles

   Settings → Appearance → Window style: Solid, Acrylic or Mica, with an opacity slider and optional translucent terminal panes.

3. 3

   Font size

   Settings → Appearance, or Ctrl+ / Ctrl− / Ctrl0 inside a pane.

4. 4

   Updates

   Settings → Updates → Check for updates. When a release is waiting, an Update button appears in the activity rail above Help and turns into “Restart to update” once it has downloaded. On Pro, new builds download in the background and restart into place; the free tier updates manually from the download page.

Ctrl + Shift + T

New pane in the current workspace

Ctrl + Alt + → / ↓

Split the active pane right / down

Ctrl + Shift + 0

Even out every pane’s size

Ctrl + Shift + E

Expand / restore the active pane

Ctrl + Shift + W

Close the active pane

Ctrl + Tab

Next pane

Alt + 1 … 9

Jump to pane 1–9

Ctrl + Shift + N

New workspace

Ctrl + Shift + PgDn / PgUp

Next / previous workspace

Ctrl + B

Toggle the sidebar

Ctrl + Shift + X

Start / stop voice input (F5 on macOS)

Ctrl + Shift + R

Recover a stuck full-screen program

Ctrl + + / − / 0

Terminal font size up / down / reset