You can configure application-wide settings via the Settings page. To access it, click the ⚙️ icon in the sidebar or select “Settings” from the top-right menu.
Vibe Kanban global settings page showing theme options, agent configuration, and GitHub integration settings

Themes

Switch between light and dark themes to suit your preference.

Default Agent Configuration

Choose the default agent and variant for new task attempts. This profile is pre-selected when creating new task attempts and follow-ups.
  1. Select an agent (e.g., Claude Code, Gemini CLI, Codex)
  2. Choose a variant if available (e.g., Default, Plan, Router)
You can override the default agent configuration per attempt in the create attempt dialog.

Editor Integration

Configure integration with your preferred code editor (e.g., VS Code) for a seamless development workflow.

GitHub Integration

Link your GitHub account by providing a Personal Access Token (PAT) to enable:
  • Automatic branch management
  • Pull request creation and tracking
  • Status synchronisation directly from Vibe Kanban

Notifications

Toggle sound effects and push notifications to stay informed about task status changes.

Telemetry

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

Task Templates

Manage global task templates to accelerate task creation across all projects. Templates allow you to define reusable titles and descriptions for common tasks.

Learn more about task templates

Complete guide to creating and managing task templates

Agent Settings (Profiles & Variants)

Define and customise agent variants under Settings → Agents. Variants let you maintain multiple configurations for the same agent (for example, a Claude Code “PLAN” variant).

Agent Profiles & Variants

Detailed guide with examples for configuring agent variants

Safety & Disclaimers

Manage acknowledgments and reset options for onboarding, safety disclaimers, and telemetry notices.
  • Onboarding: Reset the onboarding process to rerun the initial setup.
  • Safety Disclaimer: Reset or review the safety disclaimer prompt.
  • Telemetry Notice: Reset or review the telemetry data collection acknowledgment.