Dream
DocumentationDownload
Configuration and help

Settings reference

Find model defaults, providers, prompts, skills, MCP servers, and archived-chat controls.

Open Settings with the gear icon at the top of Dream. The sidebar has General, Providers, Keyboard shortcuts, Prompts, Skills, MCP servers, Connections, and Archived chats. General preferences apply as you select them. Forms for prompts, skills, and server definitions have their own Create or Save action.

General#

SettingWhat it controls
LanguageThe interface language
TerminalThe shell used for new terminal sessions
ThemeSystem, Light, or Dark appearance
Base colorThe interface's gray tones
Accent colorPrimary actions and active states

Changing the terminal shell affects new sessions. Open a new terminal to use the selection; see Terminals.

Choose a theme, then adjust the base and accent colors.

Chat messages#

SettingDefaultWhat it controls
Show reasoning summariesOnDisplay of summaries supplied by the model
Group tool callsOffCompact grouping of tool activity
Expand tool callsOffWhether tool-call details start expanded
Change checkpointsOnSnapshots project files before each reply so you can review and restore changes

The display settings affect conversations across projects. They do not change the model's reasoning effort or grant additional tool permissions. Turning off Change checkpoints stops new snapshots; see Reviewing and restoring changes.

Desktop alerts and optional sounds are configured here with Desktop notifications and Notification sound. See Follow work in progress.

Chat messages

Models#

The Models group is at the top of General.

SettingScope
Default chat modelNewly created chats across projects
Default permissionsAsk, Accept edits, or Full access for new chats
EffortReasoning effort for new chats, when supported by the default model
SpeedSpeed tier for new chats, when supported by the default model
Text generation modelGenerated commit messages and pull-request text, with its own effort and speed

Existing chats retain their own selections. Enable a model under Providers before choosing it as a default. Follow Models and defaults for the complete setup workflow.

Use the Models group to set defaults for chats and Git drafting.

Providers#

Each provider card shows its detected CLI status, installed version, refresh action, and an enable switch. Enable the provider and individual models to make them available in selectors. An Update available badge shows a newer CLI version when detected; update the CLI outside Dream and refresh the card afterward.

Dream skips CLI update checks for disabled providers. Enable a provider before checking its available updates.

Install and sign in through the provider's CLI outside Dream, then refresh its card. Dream settings do not replace the CLI's authentication flow. See Connect a provider.

Connections#

Connections has two parts:

SectionWhat you can do
Remote hostsAdd SSH hosts or pair hosts over HTTPS, order each host's routes, and connect, disconnect, or remove hosts. See Remote hosts
Remote accessLet phones, browsers, and other Dream desktops use this computer's projects, and pair or revoke devices. See Remote access

Prompts, Skills, and MCP servers#

SectionWhat you can do
PromptsCreate, preview, copy, reorder, and edit reusable prompts for any project's chat
SkillsBrowse skills by provider and project, preview SKILL.md files, and create new skills
MCP serversAdd or import tool servers and manage their connection settings

Keyboard shortcuts#

Keyboard shortcuts

Open Settings → Keyboard shortcuts, search for an action, and click its shortcut to record a new key combination. Press Enter or click Save to apply it, or Escape to cancel.

If another configurable action uses the combination, saving moves it to this action. Reserved shortcuts cannot be reassigned. Use Reset shortcut for one action or Reset all to restore defaults. The Built in section lists fixed shortcuts.

Archived chats#

ControlWhat it does
Row checkboxesSelect archived conversations across projects
Header checkboxSelect all archived conversations
RestoreReturns selected chats to active history
DeletePermanently removes selected chats and messages from Dream
Archive chats afterSets the inactivity cutoff in days; default 30
Archive nowArchives chats that meet that cutoff

The cutoff does not schedule an automatic job. See Archiving and restoring chats before using bulk actions or permanent deletion.

Controls outside Settings#

Some preferences belong to individual chats or projects. Set a chat's model, effort, speed, and permissions in its composer. Toggle multi-chat in the left toolbar. Resize chat columns and tool panels directly in the workspace.