Opening Settings
- Press
Cmd+,/Ctrl+, - Click the Settings button in the sidebar bottom toolbar or Dashboard toolbar
- Use the Command Palette (
Cmd+K) and select "Open Settings"
Settings Layout
The settings panel is a full-screen modal with:
- Left sidebar (220px) — Category navigation and scope switcher
- Content area (max 640px, centered) — The actual settings controls
- Version number at the bottom of the sidebar
Scopes
Global Settings
Apply to the entire app and all projects. Categories:
- General — Appearance, CLI, terminal, behavior
- AI & Models — Default model, model memory
- Permissions — Default permission mode
- Shortcuts — Keyboard shortcut customization
- MCP Servers — Global MCP server configuration
- Skills — Global skills
- Agents — Global agent definitions
- Integrations — Supabase, Vercel, GitHub connections
- Rules — Global Claude rules
- Mobile Access — Mobile bridge configuration
- About — Version info and links
Project Settings
Scoped to a specific project. Override global settings where applicable. Categories:
- General — Project-specific general settings
- Permissions — Project-level permission overrides
- MCP Servers — Project-specific MCP servers
- Skills — Project-specific skills
- Agents — Project-specific agents
- Integrations — Project-specific Supabase/Vercel/GitHub
- Rules — Project-specific Claude rules
Switching Scope
Use the scope dropdown at the top of the settings sidebar to switch between "Global" and any of your registered projects. The badge next to "Settings" shows the current scope.
General Settings
Appearance
- Theme — A grid of theme swatches. Click any swatch to apply it instantly. A "System" button follows your OS dark/light preference.
- UI Scale — Four size options: 90%, 100%, 110%, 120%. Changes the base font and element sizes.
New Session
- Default View — Choose whether new sessions open in Chat (SDK backend) or Terminal (CLI backend) mode.
Claude CLI
- Status — Shows the detected CLI version and binary path with a green checkmark
- Custom binary path — Override the auto-detected path if needed
Claude SDK
- Version — Shows the installed SDK package version
- Check for updates — Button to check for newer versions
- Update — Button to install the latest version (appears when updates are available)
Voice Input
- OpenAI API key — Enter your OpenAI API key to enable voice-to-text input (password field with show/hide toggle)
Terminal
- Default Shell — Dropdown to select your preferred shell (bash, zsh, fish, etc.)
- Font Size — Adjust with
+and-buttons
Behavior
| Toggle | Description |
|---|---|
| Restore Sessions on Launch | Reopen previous sessions when starting the app |
| Show in Menu Bar | Show Pandev icon in the system menu bar / tray |
| Launch at Login | Start Pandev when you log into your computer |
| Notification Sound | Play a sound when Claude finishes a response |
Turn Stats
Control what information is shown after each Claude response:
| Toggle | Description |
|---|---|
| Show Turn Stats | Master toggle for the stats bar |
| Show Cost | Display estimated API cost |
| Show Duration | Display response time |
| Show Turns | Display turn count |
| Show Tokens | Display token usage breakdown |
Project Settings (Scope-Specific)
When you switch to a project scope in settings, additional project-level options appear:
- Project Name — Edit the display name
- App Root — Set the root directory (for monorepos where the app isn't at the project root)
- Port — Dev server port number
- Dev Command — The command to start the dev server
- Auto-start Dev Server — Toggle to start the dev server automatically
- Permissions — Project-specific permission mode override
- Color — Choose a project color for the sidebar
Command Palette
The Command Palette provides quick access to all major actions through a keyboard-driven search interface.
MCP Servers
MCP (Model Context Protocol) servers extend Claude's capabilities by giving it access to external tools and data sources. Pandev lets you configure MCP servers both globally and per-project.