Documentation

Providers

Built-in local-CLI providers known to Vibestrate's detector.

Built-in providers Vibestrate detects and auto-configures. Each ships a preset (the non-interactive invocation) and a login command to run outside Vibestrate when the provider isn't authenticated. Verify any provider with `vibe provider test <id>`.

Claude Code id: claude preset-ready

Detected via claude --version.

Default args: -p with prompt on stdin.
Vibestrate will configure Claude Code automatically.

Install: Install Claude Code: `npm install -g @anthropic-ai/claude-code`, then run `claude` once to sign in.

Codex CLI id: codex preset-ready

Detected via codex --version.

Preset: `codex exec` with the prompt on stdin.
Verify with `vibe provider test codex`; log in with `codex login` if prompted.

Install: Install the Codex CLI: `npm install -g @openai/codex`, then run `codex login`.

Gemini CLI id: gemini preset-ready

Detected via gemini --version.

Preset: prompt piped to `gemini` on stdin.
Verify with `vibe provider test gemini`; sign in by running `gemini` once (or set GEMINI_API_KEY).

Install: Install the Gemini CLI: `npm install -g @google/gemini-cli`, then run `gemini` once to authenticate.

OpenCode id: opencode needs setup

Detected via opencode --version.

Preset: `opencode run` with the prompt as an argument.
Verify with `vibe provider test opencode`; log in with `opencode auth login`.

Aider id: aider preset-ready

Detected via aider --version.

Preset: `aider --message` (one-shot, no auto-commits).
Set OPENAI_API_KEY or ANTHROPIC_API_KEY, then verify with `vibe provider test aider`.

Install: Install Aider: `python -m pip install aider-install && aider-install`, then set OPENAI_API_KEY or ANTHROPIC_API_KEY.

Ollama id: ollama preset-ready

Detected via ollama --version.

Preset: `ollama run qwen3.5` with the prompt on stdin.
Pull the model first (`ollama pull qwen3.5`), or edit providers.ollama.args for another local model.
No login needed (runs locally). Verify with `vibe provider test ollama`.

Install: Install Ollama: `curl -fsSL https://ollama.com/install.sh | sh` (Linux/macOS) or download it from https://ollama.com/download.

Qwen Code id: qwen needs setup

Detected via qwen --version.

Preset: prompt piped to `qwen` on stdin.
Verify with `vibe provider test qwen`; authenticate by running `qwen` once.

Install: Install Qwen Code: `npm install -g @qwen-code/qwen-code`.

Crush id: crush needs setup

Detected via crush --version.

Preset: `crush run` with the prompt as an argument.
Set your model provider's API key, then verify with `vibe provider test crush`.

Install: Install Crush: `brew install charmbracelet/tap/crush` (macOS) or see https://github.com/charmbracelet/crush.

Goose id: goose needs setup

Detected via goose --version.

Preset: `goose run -t` with the prompt as an argument.
Run `goose configure` to set your provider + key, then verify with `vibe provider test goose`.

Install: Install Goose: see https://block.github.io/goose/.

Cursor CLI id: cursor needs setup

Detected via cursor-agent --version.

Preset: `cursor-agent -p` with the prompt as an argument.
Log in with `cursor-agent login`, then verify with `vibe provider test cursor`.

Install: Install the Cursor CLI: `curl https://cursor.com/install -fsS | bash`.

Amp id: amp needs setup

Detected via amp --version.

Preset: `amp -x` with the prompt as an argument.
Log in with `amp login`, then verify with `vibe provider test amp`.

Install: Install Amp: `npm install -g @sourcegraph/amp`.