Skip to main content
dotbot is multi-provider by design. You can switch between Claude, Codex, Antigravity, Copilot, and OpenCode from the Settings tab in the dashboard or by editing .bot/.control/settings.json, without changing any workflow files. Each provider has its own model configuration and permission modes. The runtime normalises invocations across all providers, so your workflow files stay the same regardless of which provider is active. Each provider is configured by a file at content/settings/providers/<name>.json inside your dotbot installation. These files define the CLI executable, permission modes, and capability flags for each provider.

​
Supported providers

​
Claude

Anthropic’s Claude CLI. Permission modes:
  • bypassPermissions - Passes --dangerously-skip-permissions to the CLI. The agent operates without any permission prompts. Works on all plans and models.
  • auto - AI classifier approves or blocks each action. Available on Max, Team, Enterprise, and API plans. Not available on the Pro plan or with the fast model tier.
Model tiers (defaults):

​
Codex

OpenAI’s Codex CLI. Permission modes:
  • bypass - Passes --dangerously-bypass-approvals-and-sandbox to the CLI. Skips all approval and sandbox checks.
  • full-auto - Workspace-scoped auto-approve with on-request approval for risky operations.
Model tiers (defaults):

​
Antigravity

Google’s Antigravity CLI (agy). This provider replaces the previous Gemini provider. Permission modes:
  • yolo - Auto-approves all tool calls without prompts.
  • auto_edit - Uses Antigravity’s default permission review flow.
Model tiers (defaults):

​
Copilot

GitHub Copilot CLI. Permission modes:
  • bypass - Allows all tools, paths, and URLs; disables user prompts; enables autonomous continuation.
  • workspace - Allows local read, write, and shell tools across the workspace without granting access to all URLs.
Model tiers (defaults): Copilot manages its own model routing, so dotbot passes auto for all tiers by default. You can set a specific model ID in the providers.copilot.models block if you want to pin a particular model.

​
OpenCode

OpenCode by SST. Permission modes:
  • bypass - Auto-approves permissions that are not explicitly denied.
Model tiers (defaults):

​
Per-task model selection

Individual tasks can override the process-level model tier by setting the model field in task_create or in the workflow’s tasks array. This lets you use faster models for simple tasks and reserve more capable models for complex architectural work.
The model field accepts a tier name: fast, balanced, or best. dotbot resolves the tier to the concrete model ID using the active provider’s model map in the providers block of your settings. The default tier for both analysis and execution is best.
Model tiers are provider-agnostic names. Setting model: "best" for a Claude task resolves to claude-opus-4-7 by default; the same setting for an OpenCode task resolves to opencode-go/kimi-k2.6. You can override these mappings in the providers block of your settings file.

​
Provider detection in the dashboard

The Settings tab automatically detects installed AI CLIs by scanning the system PATH. For each provider it reports:
  • Whether the CLI is installed.
  • The detected version.
  • Authentication status (logged in / API key present / not authenticated).
This detection runs when the Settings tab is first opened, giving you immediate visibility into which providers are available before starting a workflow.

​
Switching providers

You can switch providers in two ways: Via the Settings tab: Open the dashboard, go to the Settings tab, and select a provider from the Provider dropdown. The change is written to .bot/.control/settings.json and takes effect immediately for the next workflow run. Via settings.json directly: Edit .bot/.control/settings.json:
Valid values: claude, codex, antigravity, copilot, opencode.
Switching providers mid-workflow is supported but may produce inconsistent results if the new provider’s models have different context window sizes or capability profiles. Complete or pause the current workflow before switching providers.