App Settings

Open App Settings with Cmd+, or from the app side menu.

Settings are organized into categories in the left sidebar.

Account

Appearance

Customize the look of the IDE:

Window appearance — choose Auto, Light, or Dark
Current preset — select a built-in preset grouped by category, or choose Custom Vibes to edit the palette. Custom themes provide 11 color roles, including Muted Foreground for secondary labels, metadata, and de-emphasized text.
Typography — set the font family, text size, and code and terminal text color
Text size — a 1–100 pt slider (default 13 pt) that scales app text, icons, editors, terminals, and rendered documents. Cmd++/Cmd+=, Cmd+-, and Cmd+0 adjust the same value; see Keyboard Shortcuts.
Rail terminal font scale — adjust terminal text in the stacked and rail views
Border shape — choose rounded or square corners for UI elements
Show borders — show or hide borders between panes
Rail position — place the rail on the left, right, top, or bottom for new VibeSpaces
App side menu dock — position the app menu

Line Numbers

Show line numbers controls file line numbers across text editors:

Option	Effect
Off	Hides line numbers everywhere, including the old/new columns in Git diffs
Source Editors (default)	Shows line numbers in code, source, and plain-text editors and in Git diffs
All Text Views	Also labels each block in rich Markdown and the LaTeX Edit tab with the source line it starts on

Open documents update immediately. Browser, image, PDF, notebook, whiteboard, terminal, and Office views never show file line numbers. See Code Editor.

Markdown Web Links

Open web links in sets what a normal click on an HTTP(S) link does in rendered Markdown:

Option	Effect
Ask Each Time (default)	Shows a popover to choose Open in Crispy or Default Browser
Crispy Browser	Opens the link in CrispyVibe’s built-in browser
Default Browser	Opens the link in your macOS default browser

Right-click always offers both destinations. Section links and linked project files always stay inside CrispyVibe. See Markdown Editor.

VibeSpaces

Manage your VibeSpace library:

Table view — lists every VibeSpace on disk with Name, Project Folders, and Actions columns. Recent VibeSpaces sort to the top.
Search — filter by VibeSpace name or any project path
Multi-select — Cmd-click to select multiple VibeSpaces for bulk operations
Project folder links — click any project folder to reveal it in Finder; hover to see the full path
Open / Delete — open a VibeSpace with its row’s open icon, by double-clicking the row, or with Open. Delete with the row’s trash icon, Delete, or the right-click menu.

🚨 Warning: Deleting a VibeSpace permanently removes its saved state (terminals, browsers, layout, and project configuration). CrispyVibe asks for confirmation first, and closes the VibeSpace if it is open.

Keyboard Shortcuts

View and rebind app-wide keyboard shortcuts. Each shortcut can be recorded, disabled, or reset to its default. You can also configure the terminal inline trigger shortcut here.

The text-size actions appear here as Increase Font Size, Decrease Font Size, and Reset Font Size. See Keyboard Shortcuts.

Screen Capture

Configure Screen Capture:

Screenshot Shortcut — the system-wide capture shortcut (default Ctrl+Shift+4) and whether it registered or conflicts with another app
Remembered mode, Delay, and Include pointer — the options your next capture starts with
Screen Recording Permission — the permission status, with recovery actions when access is missing
Clear Screenshot History — the number of saved screenshots and a button to remove them

Terminal

Configure terminal behavior:

Default terminal shell — set the shell for new terminals
Terminal engine — choose Ghostty (default) or SwiftTerm
tmux Integration — enable tmux-backed terminals, then choose what happens On quit and On tab close: Detach (keep alive) or Terminate. Manage Sessions lists running tmux sessions.

AI Services

Set defaults for text actions:

CLI defaults — choose a CLI profile, then adjust the Trust mode, CLI command, CLI arguments, Default agent, and whether to pass the --agent argument
Prompt templates — customize the rephrase and research prompts
Reset Service Defaults — restore the defaults

Agents

Configure AI agent defaults:

Default agent — choose which agent connects by default
Model — set the default model
Reasoning level — set the default reasoning level
Trust mode — choose Standard or Full Trust as the default
Custom agents — add agents by specifying a title, executable, and arguments

Updates

Automatically check for updates — enable or disable automatic update checks
Update channel — choose Stable, Dev, or Custom
Custom feed URL — provide an appcast URL; this field appears only when you choose Custom

Experimental

Toggle experimental feature flags. Features behind these gates may be incomplete or unstable.

ACP Diagnostics — show ACP diagnostics in Developer Tools
Terminal Insight — show your last command at the top of each terminal

⚠️ Note: Experimental features can change or be removed without notice.

Connections

Manage SSH profiles for remote development. Add, edit, or remove SSH connection configurations.

Reset

Use Reset Local State to remove local VibeSpaces, recents, Shelf contents, layout customizations, walkthrough progress, and app-level overrides from this Mac.

🚨 Warning: This action cannot be undone.

VibeSpace-scoped settings

Some settings apply per-VibeSpace rather than globally. These live in VibeSpace Settings and include:

Project-specific keyboard shortcuts
Project colors
Startup overrides

Open VibeSpace Settings from the command palette or the VibeSpace menu.