Skip to main content
Bolt is model-agnostic by design. Under the hood it uses the Vercel AI SDK to speak to providers, which means any provider the SDK supports — Anthropic, OpenAI, Google, Amazon Bedrock, OpenRouter, and more — works out of the box. The provider and model catalog is sourced from models.dev, a community-maintained database of provider metadata and pricing.

Managing provider credentials

Use bolt providers (aliased as bolt auth) to add, list, and remove provider credentials.

Add or update credentials

This launches an interactive prompt to select a provider and enter credentials. To skip the interactive flow, pass flags directly:

List configured providers

Displays all stored credentials and any provider API keys detected from environment variables.

Remove credentials

Environment variable authentication

For CI pipelines or headless environments, set the provider’s API key environment variable directly — no interactive login required. Common examples:
Bolt reads these variables automatically at startup. bolt providers list will surface which environment variables it detected.

Browsing available models

bolt models lists every model available across your configured providers.
Run bolt models --verbose to see input/output token pricing for every model. This makes it easy to compare cost trade-offs before committing to a model for a long-running task.

Model identifier format

Models are always referenced in provider/model format:
Use this format anywhere Bolt accepts a model — CLI flags, config files, and agent definitions.

Selecting a model at runtime

--model / -m flag

The --model flag is available on bolt run, bolt commit, and bolt review:

--variant — controlling reasoning effort

Some models support configurable reasoning effort levels (e.g., Anthropic’s extended thinking, OpenAI’s reasoning models). Use --variant to select the effort tier:
The available variant values depend on the provider and model. Common values are minimal, low, medium, high, and max, but the exact set varies. Check your provider’s documentation or use bolt models --verbose to see supported variants for a given model.

--thinking — show reasoning blocks

When using a model that supports extended thinking, pass --thinking to surface the model’s chain-of-thought in the output:

Best-of-N parallel runs

--best-of fires the same prompt at multiple models in parallel, then uses a judge model to rank the responses and keep the best one:
The judge defaults to the model passed via --model, or to the first entry in the --best-of list if --model is not set. The flag accepts a comma-separated list of provider/model identifiers.
Best-of-N is especially useful for complex algorithmic problems or architecture decisions where different models may bring genuinely different approaches. Let Bolt run them in parallel and pick the winner automatically.