Agent profiles let you define multiple named variants for each supported coding agent. Variants capture configuration differences like planning mode, model choice, and sandbox permissions that you can quickly select when creating attempts.
Agent profiles are used throughout Vibe Kanban wherever agents run: onboarding, default settings, attempt creation, and follow-ups.

​
Configuration Access

You can configure agent profiles in two ways through Settings → Agents:
Use the guided interface with form fields for each agent setting.
Agent configuration form editor interface
The configuration page displays the exact file path where your settings are stored. Vibe Kanban saves only your overrides whilst preserving built-in defaults.

​
Configuration Structure

The profiles configuration uses a JSON structure with an executors object containing agent variants:
profiles.json
{
  "executors": {
    "CLAUDE_CODE": {
      "DEFAULT": { "CLAUDE_CODE": { "dangerously_skip_permissions": true } },
      "PLAN":    { "CLAUDE_CODE": { "plan": true } },
      "ROUTER":  { "CLAUDE_CODE": { "claude_code_router": true, "dangerously_skip_permissions": true } }
    },
    "GEMINI": {
      "DEFAULT": { "GEMINI": { "model": "default", "yolo": true } },
      "FLASH":   { "GEMINI": { "model": "flash",   "yolo": true } }
    },
    "CODEX": {
      "DEFAULT": { "CODEX": { "sandbox": "danger-full-access" } },
      "HIGH":    { "CODEX": { "sandbox": "danger-full-access", "model_reasoning_effort": "high" } }
    }
  }
}

​
Agent Configuration Options

​
plan
boolean
Enable planning mode for complex tasks
​
claude_code_router
boolean
Route requests across multiple Claude Code instances
​
dangerously_skip_permissions
boolean
Skip permission prompts (use with caution)
View full CLI reference →

​
Universal Options

These options work across multiple agent types:
​
append_prompt
string | null
Text appended to the system prompt
​
base_command_override
string | null
Override the underlying CLI command
​
additional_params
string[] | null
Additional CLI arguments to pass
Options prefixed with “dangerously_” bypass safety confirmations and can perform destructive actions. Use with extreme caution.

​
Using Agent Configurations

Default Configuration

Set your default agent and variant in Settings → General → Default Agent Configuration for consistent behaviour across all attempts.

Per-Attempt Selection

Override defaults when creating attempts by selecting different agent/variant combinations in the attempt dialogue.
MCP (Model Context Protocol) servers are configured separately under Settings → MCP Servers but work alongside agent profiles to extend functionality.

MCP Server Configuration

Configure MCP servers within Vibe Kanban for your coding agents

Vibe Kanban MCP Server

Connect external MCP clients to Vibe Kanban’s MCP server