Skip to main content
This is the new Settings UI currently in Beta. It provides the same configuration options with a redesigned interface accessible from the Workspaces UI.
The General tab contains application-wide settings for appearance, default agent, editor configuration, git preferences, and notifications.
General settings tab showing appearance, default agent, and editor options

​
Appearance

Customise how the application looks and feels:
  • Theme - Choose between Light and Dark colour schemes
  • Language - Select your preferred language (Browser Default follows your system language)

​
Default Coding Agent

Default Coding Agent section showing agent and variant dropdowns
Set the coding agent that will be used by default when creating new task attempts or follow-ups.
  • Agent - Select your preferred coding agent (e.g., Claude Code, Gemini CLI, Codex). This determines which AI assistant handles your coding tasks.
  • Variant - Choose a configuration variant for the selected agent (e.g., Default, Opus, Approvals). Variants contain different settings like planning mode, model selection, or permission levels.
The selected agent and variant appear pre-selected in the attempt creation dialog, saving you time when starting new tasks.
You can override the default agent configuration per attempt in the create attempt dialog. The default is just a convenience for your most common workflow.

​
Editor

Editor settings showing Editor Type dropdown and Remote SSH Host input
Configure your code editing experience.

​
Selecting Your Editor

Choose from various supported editors:
  • VS Code - Microsoft’s popular code editor
  • Cursor - VSCode fork with AI-native features
  • Windsurf - VSCode fork optimised for collaborative development
  • Zed - High-performance code editor
  • Antigravity - Google’s AI-native code editor
  • Neovim, Emacs, Sublime Text - Other popular editors
  • Custom - Use a custom shell command

​
Custom Editor Example

When selecting Custom, you can specify any shell command to open files. The command receives the file or directory path as an argument. 
# Example: Open with IntelliJ IDEA
idea

# Example: Open with Sublime Text (custom path)
/Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl

# Example: Open with a custom script
~/scripts/open-editor.sh

​
Opening Your Editor

Open in IDE option in the context bar
Once configured, you can open your editor from several places:
  • Context bar - Click your IDE logo icon in the floating context bar to open the workspace
  • Command bar - Press Cmd/Ctrl + K and select “Open in IDE”
The context bar shows your configured IDE’s logo. For more details, see the Workspaces Interface Guide.

​
Remote SSH Configuration

When running Vibe Kanban on a remote server (e.g., accessed via Cloudflare tunnel, ngrok, or as a systemctl service), you can configure VSCode-based editors to open projects via SSH instead of assuming localhost. This feature is available for VS Code, Cursor, and Windsurf editors.

​
When to Use Remote SSH

Enable remote SSH configuration when:
  • Vibe Kanban runs on a remote server (VPS, cloud instance, etc.)
  • You access the web UI through a tunnel or reverse proxy
  • Your code files are on a different machine than your browser
  • You want your local editor to connect to the remote server via SSH

​
Configuration Fields

  • Remote SSH Host (Optional) - The hostname or IP address of your remote server (e.g., example.com, 192.168.1.100, my-server). Must be accessible via SSH from your local machine.

​
How It Works

When remote SSH is configured, clicking “Open in Editor” (or Cursor/Windsurf):
  1. Generates a special protocol URL like: vscode://vscode-remote/ssh-remote+user@host/path/to/project
  2. Opens in your default browser, which launches your local editor
  3. Your editor connects to the remote server via SSH
  4. The project or task worktree opens in the remote context
This works for both project-level and task worktree opening.

​
Prerequisites

  • SSH access configured between your local machine and remote server
  • SSH keys or credentials set up (no password prompts)
  • VSCode Remote-SSH extension installed (or equivalent for Cursor/Windsurf)
  • The remote server path must be accessible via SSH
Test your SSH connection first with ssh user@host to ensure it works without prompting for passwords.

​
Git

Git settings showing Branch Prefix and Workspace Directory fields
Configure git branch naming and workspace storage preferences.

​
Branch Prefix

Set a prefix for auto-generated branch names. When you create a new workspace or task, Vibe Kanban automatically creates a git branch for your changes.
Prefix SettingExample Branch Name
vkvk/1a2b-implement-auth
featurefeature/1a2b-implement-auth
(empty)1a2b-implement-auth
Use a prefix that matches your team’s branching conventions (e.g., feature, fix, or your initials).

​
Workspace Directory

Specify where Vibe Kanban stores workspace data. Workspaces are created in a .vibe-kanban-workspaces subdirectory within this path.
  • Default location - Leave empty to use the system default (typically your home directory)
  • Custom location - Set a specific path if you prefer workspaces on a different drive or directory
Changes to Workspace Directory require an app restart. Existing workspaces remain in their original location.

​
Notifications

Notifications settings showing sound effects and push notifications toggles
Configure how Vibe Kanban alerts you about task progress and status changes.
  • Sound Effects - Play audio notifications when tasks complete, need attention, or encounter errors. Useful when working with multiple tasks or when Vibe Kanban runs in a background tab.
  • Push Notifications - Receive browser notifications even when Vibe Kanban isn’t in focus. Requires browser permission when first enabled.
Enable notifications if you frequently run long-running tasks and want to be alerted when they complete or need your attention.

​
Telemetry

Enable or disable telemetry data collection to help improve Vibe Kanban.

​
Message Input

Choose the keyboard shortcut to send messages in the chat input (Enter or ⌘/Ctrl + Enter).

​
Tags

Tags section showing task tags table with tag names, content, and actions
Create reusable text snippets that can be inserted into workspace prompts using @tag_name.
  • Add Tag + - Create a new tag
  • Tag Name - The @mention name for the tag
  • Content - The text that will be inserted
  • Actions - Edit or delete existing tags

Learn more about tags

Complete guide to creating and managing tags

​
Beta Features

Enable or disable beta features to try new functionality before general release.

​
Workspaces Beta

The new Workspaces UI is a complete redesign of the task execution experience with multi-repository support, multiple agent sessions, and an integrated preview browser. When enabled, you can access it by clicking on any task attempt. To enable or disable Workspaces:
  1. Find the Beta Features section
  2. Toggle Enable Workspaces Beta

Workspaces Documentation

Complete guide to using the new Workspaces UI