Dashboard: Settings
The Settings tab in the Dashboard provides centralized configuration for Klip's behavior and appearance.
Access: Klip: Open Dashboard (klip.openDashboard) > Settings tab
Settings Sections
The Settings tab contains 10 sections, accessible via the sidebar navigation.
Terminal
Configure terminal behavior in Klip Panel:
| Setting | Description |
|---|---|
klip.terminalLocation | Where terminals open (editor area or panel) |
klip.terminalBackend | Rendering backend (legacy or native) |
klip.preferredShell | Shell to use (auto, bash, zsh, pwsh, wsl) |
Terminal UI
Configure terminal header display:
| Setting | Description |
|---|---|
klip.terminal.showActions | Show action buttons in header |
klip.terminal.showEnvButton | Show environment variable button |
klip.terminal.showTagsButton | Show tags button |
klip.terminal.showForkButton | Show fork button (currently disabled) |
klip.terminal.showExportButton | Show export button |
klip.terminal.showShellBadge | Show shell type badge |
klip.terminal.showShortId | Show shortened session ID |
klip.terminal.enableTitleEdit | Allow editing terminal title |
Appearance
Terminal appearance customization:
These settings are saved but not yet applied to terminal renderers. Full customization is planned for a future release.
- Theme selection (Dracula, Nord, Monokai, etc.)
- Font family, size, weight
- Cursor style (block, underline, bar) and blinking
- Status bar visibility and height
Button Library (Pro)
Button Library requires Klip Pro.
Customize the terminal toolbar with reusable buttons:
- Command buttons - Run shell commands
- Prompt buttons - Send prompt templates
- Dropdown buttons - Choose from a list
See Klip Panel for details.
Sessions & UI
Configure session display behavior:
| Setting | Description |
|---|---|
klip.archiveAfterDays | Auto-archive sessions older than N days |
klip.showArchived | Show archived sessions in lists |
Tags (Pro)
Tag configuration requires Klip Pro.
Manage reusable tags with attached configuration:
- Environment Variables - Variables automatically set for sessions with this tag
- Init Scripts - Scripts that run when sessions with this tag start
Tags allow you to configure once and apply everywhere. All sessions sharing a tag inherit its environment variables and init scripts.
| Action | Description |
|---|---|
| Create Tag | Add a new tag with optional env vars and scripts |
| Edit Tag | Modify tag name and configuration |
| Delete Tag | Remove tag (does not affect sessions) |
| Add Env Var | Add environment variable to tag |
| Add Script | Add init script to tag |
Paths & Discovery
Configure where Klip looks for sessions:
| Setting | Description |
|---|---|
klip.additionalSessionPaths | Additional directories to scan |
Default locations are always scanned:
- Claude:
~/.claude/projects/ - Codex:
~/.codex/sessions/ - Gemini:
~/.gemini/tmp/
Summaries
Configure AI summary generation:
| Setting | Description |
|---|---|
klip.defaultSummaryModel | Model for generating summaries |
klip.autoGenerateSummaries | Auto-generate for new sessions |
klip.summary.full.context.* | Context size and content settings |
See Session Details for full documentation.
Network
Configure daemon connectivity:
| Setting | Description |
|---|---|
klip.daemon.url | Daemon API URL (default: auto) |
klip.daemon.timeout | Request timeout in ms |
klip.daemon.keepAlive | Keep daemon running after VS Code closes |
MCP Gateway (Pro)
MCP Gateway requires Klip Pro.
Configure the MCP Gateway for routing MCP server requests:
- Gateway status and controls
- Server routing configuration
- Connection management
See MCP Panel for MCP server management.
Related
- Dashboard: Developer - Logging, API keys
- Dashboard: Agents - Agent configuration
- Klip Panel - Terminal workspace