# Using Novadeck A quick tour. Every detail is in the [reference](reference.md). ## Install On macOS and x86_64 Linux: ```sh curl -fsSL https://novadeck.dev/install.sh | sh ``` For Windows and portable builds, see [novadeck.dev/download](https://novadeck.dev/download). ## Connect your agents Novadeck runs the agent CLIs you already have, so install at least one and sign in to it first: - [Claude Code](https://code.claude.com/docs/en/setup): `claude` - [Codex](https://developers.openai.com/codex/cli): `codex` - [Antigravity CLI](https://antigravity.google/docs/getting-started?tab=cli): `agy` ![The welcome dialog: Claude Code and Codex ticked, Antigravity not installed, and a Let's build something button.](assets/guide/welcome.webp) When you first open Novadeck, tick the agents you use. Novadeck adds a small plugin to each, so it can resume them after a restart and pass messages between them. Then start them in any terminal, the same way you always do. Codex may ask you to trust Novadeck's hooks. Do it with `/hooks`, or messages won't reach it and it won't resume after a restart. ## Three views ![Focus: one Claude Code terminal filling the window.](assets/guide/focus.webp) **Focus**: one terminal. ![Grid: four agents side by side.](assets/grid.webp) **Grid**: everything side by side, in the order of the Terminals list. Drag a terminal by its header to reorder. ![Canvas: eleven terminals arranged on a board.](assets/guide/canvas.webp) **Canvas**: every terminal on one board, laid out for you: each team beside its lead, the rest in a block in the sidebar's order. Scroll to zoom, drag to pan. ![Zen mode: only the terminals and a small dock.](assets/guide/zen.webp) **Zen** (`Ctrl+Shift+Z`, `Cmd+Shift+Z` on macOS) hides everything else. ![Search for "order" listing three matching terminals.](assets/guide/search.webp) `Ctrl+Shift+K` (`Cmd+K`) finds any terminal by name. ## The Inbox ![Claude Code asks to run its tests. The ask opens in the Inbox, Allow is picked, and the tests run.](assets/highlights/inbox.webp) When an agent wants a permission, a plan approved or an answer, it lands in the Inbox. Most of the time you answer with a button, right there. ![A plan from Claude Code in the Inbox, with Approve, auto-accept edits, Send it back and Go to terminal.](assets/guide/inbox-plan.webp) Plans show in full before you approve them. ![A toast in the corner: @dusk wants to go ahead with a plan.](assets/guide/toast.webp) If you're looking elsewhere in Novadeck, a toast pops up. If you're in another app, you get a system notification. ![A done report in the Inbox: Inventory sync is done, with Go to terminal.](assets/guide/done.webp) When an agent finishes, its short report waits here too. Opening it reads it. Nothing you have dealt with disappears: an answered question, a dismissed one, a message you released, a report you read all stay in the list in gray, saying how they ended, newest first, and open as read-only cards. The list keeps the last ten of those; only a question an agent withdrew itself leaves. ## Teams ![A lead, Orders API, wired to its three teammates.](assets/team-canvas.webp) Every terminal has a handle like `@moth`. Agents use it to message each other, and one agent can start others and lead them. The wires show who leads whom. ![The Messages pane of Orders API, with a conversation per teammate.](assets/guide/messages.webp) Once a terminal has messages, click its **Messages** icon to read its conversations with other agents. ## Agents show you their work ![An order status page shown in a pane next to the agent's terminal.](assets/guide/show-page.webp) An agent can open a page, an image, a plan or its changes in a pane right next to its terminal. ## After a restart ![Novadeck starts again and its terminals come back as they were, Claude Code's session where it left off.](assets/highlights/restore.webp) Terminals reopen where they were, and agents pick up their sessions. Closed terminals stay in History for 7 days. ## Shortcuts | Action | Windows and Linux | macOS | | ---------------------- | -------------------------------- | ------------------ | | Find a terminal | `Ctrl+Shift+K` | `Cmd+K` | | New terminal | `Ctrl+Shift+T` | `Cmd+T` | | Recent terminals | `Ctrl+Tab` | `Ctrl+Tab` | | Move between terminals | `Ctrl+Shift+↑↓←→` | `Cmd+Option+↑↓←→` | | Inbox | `Ctrl+Shift+B` | `Cmd+Shift+B` | | Zen | `Ctrl+Shift+Z` | `Cmd+Shift+Z` | | Pinned project 1–9 | `Ctrl+Shift+1` to `Ctrl+Shift+9` | `Cmd+1` to `Cmd+9` | | Preferences | `Ctrl+,` | `Cmd+,` | The full list is in the [reference](reference.md#keyboard-shortcuts).