aivo - Use your favorite coding agent with any model
Skip to content
v0.46.0<br>LINKS
~/project — aivo zsh
— 01 API key management API keys and OAuth stay encrypted on this machine. Switch whichever you need. aivo keys →<br>02 Agent launcher Launch Claude Code, Codex, Gemini, and more with keys you already added. No per-agent setup. aivo claude →<br>03 Aivo Code Aivo's own coding agent. Same keys, any model — from a frontier API to a local GGUF. aivo code →
Install<br>A single binary for macOS, Linux, WSL, and Windows. Choose the method that fits your system.
Bash PowerShell Homebrew<br>macOS / Linux / WSL<br>curl -fsSL https://getaivo.dev/install.sh | bash<br>Copied!
irm https://getaivo.dev/install.ps1 | iex<br>Copied!
brew install yuanchuan/tap/aivo<br>Copied!
Bring your own keys<br>Add API keys from any provider you trust . Keys are encrypted and stored locally, so you can manage them and switch anytime.<br>Add a key<br>Run bare to open the interactive picker, or pass flags for a non-interactive add.<br># OpenRouter, Vercel AI Gateway,<br># OpenCode Go, DeepSeek, Cloudflare,<br># Google AI Studio, Kilo Gateway,<br># Amazon Bedrock,<br># OAuth: Codex, SuperGrok, GitHub Copilot, Cursor<br># Local: Ollama, LM Studio, llama.cpp<br># more...<br>aivo keys add<br>Copied!
Export & import<br>Move keys between machines through a single password-encrypted file.<br># prompts for a password<br>aivo keys export ~/keys.bak
# same password on the other machine, or pass a URL<br>aivo keys import ~/keys.bak<br>aivo keys import https://example.com/keys.bak
# non-interactive (CI / scripts)<br>aivo keys export ~/keys.bak --password-stdin "my secret"
Copied!
Other commands<br>List, activate, inspect, edit, ping, and re-auth saved keys.<br># list all saved keys<br>aivo keys
# quickly add a key with options<br>aivo keys add --base-url https://openrouter.ai/api --key sk-xxx
# activate a key to use<br>aivo keys use<br>aivo keys use mykey
# print saved data of a key<br>aivo keys cat
# edit a saved key<br>aivo keys edit
# health-check<br>aivo keys ping
# OAuth re-login / rotate a key<br>aivo keys reauth
# for more options<br>aivo keys --help
Copied!
Keys: Add<br>Presets 55 providers · OpenRouter, Anthropic, Groq…<br>OAuth Codex, Claude Code, SuperGrok, Kimi Code<br>Other Copilot, Cursor, Ollama, starter<br>Custom URL HTTP endpoint · key + base URL
Export skips<br>Login sessions OAuth, Copilot, Cursor login · re-auth elsewhere<br>aivo starter Device-bound · never leaves this machine<br>API-key records only · password-encrypted file. Import from a path or URL.
Run a coding agent<br>Launch a coding agent with any provider or model you want. All extra arguments are passed through to the underlying tool.<br>Claude Claude Code Anthropic's official terminal coding agent. aivo claude<br>Copied!<br>Use a saved API key with -k, or omit the value to open the key picker. Pass -k alone with -m to pick both at once.<br>aivo claude -k openrouter<br>aivo claude -k copilot<br>aivo claude -k
Copied!<br>Pin a model with -m, or omit the value to open the model picker. Once a model is applied, aivo claude remembers it for the next run.<br>aivo claude -m moonshotai/kimi-k2.5<br>aivo claude -m
Copied!<br>Per-slot models Claude Code runs multiple models in a single session, haiku/sonnet/opus/fable slots plus a subagent override. Pin each slot to a different model, or pass a slot flag without a value to open the picker for that slot.<br>aivo claude --sonnet-model deepseek-v4-pro --haiku-model deepseek-v4-flash<br>aivo claude --fable-model gpt-5.4 --subagent-model claude-haiku-4-5
# open the picker for one slot<br>aivo claude --opus-model
Copied!
Codex Codex OpenAI's official Codex CLI. aivo codex<br>Copied!<br>Use a saved API key with -k, or omit the value to open the picker.<br>aivo codex -k vercel<br>aivo codex -k
Copied!<br>Pin a model with -m, or omit the value to open the model picker.<br>aivo codex -m xiaomi/mimo-v2-pro<br>aivo codex -m
Copied!<br>Per-slot models Codex runs multiple models in a single session, the main model plus review and subagent overrides. Pin each slot to a different model, or pass a slot flag without a value to open the picker for that slot.<br>aivo codex --review-model gpt-5.3-codex --subagent-model claude-haiku-4-5
# open the picker for one slot<br>aivo codex --review-model
Copied!<br>Codex desktop app (experimental) Launch the native Codex with the same backend. The app's in-app model picker only shows names starting with gpt- or claude-; other models still work, but won't appear there.<br>aivo codex-app<br>aivo codex-app -k<br>Copied!
Pi A terminal coding agent from the pi-mono toolkit. aivo pi<br>Copied!<br>Use a saved API key with -k, or omit the value to open the picker.<br>aivo pi -k cursor<br>aivo pi -k
Copied!<br>Pin a model with -m, or omit the value to open the model picker.<br>aivo pi -m composer-2.5<br>aivo pi -m
Copied!<br>Transparent mode Because Pi supports multiple upstream protocols, by default aivo puts its local router in the middle and normalizes the stream. Use --transparent to hand Pi the URL and the right API type so it talks to the provider directly.<br>aivo pi --transparent -k...