Settings

Open and find

⌘, on macOS and Ctrl+, on Windows. Inside there is a search field that finds a setting by name and shows where it lives, and the same search works from the command palette, which takes you straight to the right place without walking through the groups.

General

• Restore sessions on launch. Reopens whatever was running. On by default.
• Warn before quitting. Asks for confirmation when you close the app if an agent is working or waiting for an answer. Off by default.
• Global shortcut. Turns it on or off and picks the combination that brings Deck to the front from any application.
• Theme. System, dark or light, plus a picker with dozens of named palettes. Each session can also carry its own theme.
• Interface density. Scales all spacing, from 80 to 140 percent.
• Session minimap. A dot for every session in the bottom bar, with the state of each one.
• Color blind mode. Tool family colors you can tell apart.
• Diagnostics. The screen that checks whether the install is healthy, described in Troubleshooting.

Sessions

• Default agent for a new session and for the shortcut.
• Silence until waiting. How long the terminal goes without output before Deck decides it stopped. Applies only to what has no state integration. Two and a half seconds by default.
• Connected sessions talk without review. With the option off, every message between connected sessions waits for approval.
• Prompt library. Each saved prompt becomes an action in the palette, pasted into the focused session.

Git and worktrees

• GitHub connection, through the GitHub CLI account.
• Where worktrees live. The Deck folder, next to the repository, inside it, or a template of your own. The screen previews the path on your system.
• Delete the branch on archive. When you archive a task and remove the worktree, the branch goes with it. On by default.

What each one does is in Isolated tasks.

Terminal

• Font size and family. The list brings the monospaced fonts that ship with Deck and the ones installed on your machine, and it takes the name of any other.
• Scroll speed, in lines per gesture.
• Option as Meta, macOS only, for people who use emacs and the like. Turn it off if you type characters with the Option key.
• Accelerated rendering. With many terminals in view, the app falls back to plain drawing on its own.
• Microphone in the Claude prompt, to dictate instead of type.
• Keyboard shortcuts, which opens the sheet where every shortcut is remapped by click.

Notifications

• System notifications, with a test button. They only fire when Deck is not in focus.
• Mute for 15 minutes, 1 hour or 4 hours, with the end time in view and a resume button.
• Sound, with different sounds for asking permission and for turn finished. On Windows, the system notification center owns the sound.
• Visual alert, for people who would rather flash than beep.

Agents

• Installed agents, one card per agent, with the version or the command to install it.
• Hook state for each agent, with reinstall and remove.
• Configuration files for Claude Code and Codex, editable inside the app, validated as you type.
• Permission options for each agent, including the ones marked dangerous.
• Task prompt template, the text that opens the session of a delegated task.

Connections

• ClickUp token, kept in the system keychain, along with the lists you follow.
• GitHub account, the same one as the GitHub CLI, along with the repositories you follow.
• Task tools for agents, which let the session agent list, create, move and comment on tasks. On by default, and creating only works in the lists you follow.

Projects

This group has a project picker at the top, because everything here applies per project:

Advanced

• Check for updates, with a button to check now and the installed version in plain sight.
• Usage metrics, exported in one click. What they carry is in Account and privacy.
• User themes. Your own files in the themes folder become options in the list, and there is a reload button.
• What changed, with the notes for every version and the installed one marked.