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 new Settings dialog provides a streamlined, tabbed interface for configuring Vibe Kanban.

​
Accessing Settings

Workspaces navbar showing the Settings gear icon with tooltip
  • Click the Settings icon () in the Workspaces navbar
  • Press Cmd/Ctrl + K and select Settings

​
Settings Tabs

Settings dialog showing the tabbed interface with General, Projects, Repositories, Organization Settings, Agents, and MCP Servers tabs
The settings dialog is organised into the following tabs:
TabDescription
GeneralAppearance, default agent, editor, git, and notifications
ProjectsProject-specific settings
RepositoriesRepository scripts (dev server, setup, cleanup)
Organization SettingsOrganisation-level configuration
AgentsAgent profiles and variants
MCP ServersModel Context Protocol server configuration

​
General

Configure appearance, default agent, editor, git preferences, notifications, tags, and beta features.

General Settings

Complete guide to general settings including appearance, editor configuration, and more

​
Projects & Repositories

Configure project-specific settings and repository scripts including dev server, setup, and cleanup commands.

Projects & Repositories

Configure project settings and repository scripts

​
Organization Settings

Configure organisation-level settings that apply across all users and projects.

​
Agents

Agents tab showing agent list, configuration variants, and settings options
Define and customise agent variants using a form-based interface. The Agents tab uses a finder-style two-column layout:
  • Left column (Agents) - Available coding agents (Claude Code, Codex, Opencode, Cursor Agent, etc.)
  • Right column (Configurations) - Different variants for the selected agent (Default, Opus, Approvals, Plan, etc.)

Agent Profiles & Variants

Detailed guide with examples for configuring agent variants

​
MCP Servers

MCP Servers tab showing agent selection, JSON configuration, and popular servers
Configure Model Context Protocol servers to extend coding agent capabilities with custom tools and resources.
  • Agent - Choose which agent to configure MCP servers for (e.g., Claude Code)
  • Server Configuration (JSON) - Edit the MCP server configuration directly in JSON format
  • Popular servers - Click a card to insert a pre-configured MCP server into the JSON

Connecting MCP Servers

Configure MCP servers within Vibe Kanban for your coding agents