Settings Overview

The Settings dialog provides a streamlined, tabbed interface for configuring Vibe Kanban.

Accessing Settings

<Frame> </Frame>

• Click the Settings icon (<Icon icon="gear" />) in the Workspaces navbar
• Press Cmd/Ctrl + K and select Settings

Settings Tabs

<Frame> </Frame>

The settings dialog is organised into the following tabs:

Tab	Description
General	Appearance, default agent, editor, git, and notifications
Projects	Project-specific settings
Repositories	Repository scripts (dev server, setup, cleanup)
Organization Settings	Organisation members, invitations, and settings
Remote Projects	Cloud-synced projects across organisations
Agents	Agent profiles and variants
MCP Servers	Model Context Protocol server configuration

General

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

<Card title="General Settings" icon="gear" href="/settings/general"> Complete guide to general settings including appearance, editor configuration, and more </Card>

Projects & Repositories

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

<Card title="Projects & Repositories" icon="folder-tree" href="/settings/projects-repositories"> Configure project settings and repository scripts </Card>

Organization Settings

Manage your Cloud organisations, invite team members, and configure organisation-level settings.

<Card title="Organisation Settings" icon="buildings" href="/settings/organization-settings"> Manage members, invitations, and organisation settings </Card>

Remote Projects

View and manage all your Cloud-synced projects across organisations. Create, edit, and delete projects from a centralised interface.

<Card title="Remote Projects" icon="cloud" href="/settings/remote-projects"> Manage Cloud projects across all your organisations </Card>

Agents

<Frame> </Frame>

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.)

<Card title="Agent Profiles & Variants" icon="robot" href="/settings/agent-configurations"> Detailed guide with examples for configuring agent variants </Card>

MCP Servers

<Frame> </Frame>

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

<Card title="Connecting MCP Servers" icon="server" href="/settings/mcp-servers"> Configure MCP servers within Vibe Kanban for your coding agents </Card>

Related Documentation

• Workspaces - The Workspaces UI where settings are accessed