管理 API Key，为各类 Coding Agent 自由搭配服务商与模型；也可在内置的 Aivo Code 中即刻上手。
$ 单个二进制文件，支持 macOS、Linux、WSL 和 Windows。选择适合你系统的安装方式即可。
curl -fsSL https://getaivo.dev/install.sh | bash irm https://getaivo.dev/install.ps1 | iex brew install yuanchuan/tap/aivo 配置你信任的任意服务商 API Key。所有凭据均在本地加密存储，随时随地无缝管理与切换。
不带参数运行可打开交互式选择器，也可以传入参数以非交互方式添加。
# OpenRouter, Vercel AI Gateway,
# OpenCode Go, DeepSeek, Cloudflare,
# Google AI Studio, Kilo Gateway,
# Amazon Bedrock,
# OAuth: Codex, SuperGrok, GitHub Copilot, Cursor
# Local: Ollama, LM Studio, llama.cpp
# more...
aivo keys add 通过一个密码加密文件，在不同设备之间迁移 API Key。
# prompts for a password
aivo keys export ~/keys.bak
# same password on the other machine, or pass a URL
aivo keys import ~/keys.bak
aivo keys import https://example.com/keys.bak
# non-interactive (CI / scripts)
aivo keys export ~/keys.bak --password-stdin <<< "my secret"
列出、启用、查看、编辑、连通性探测已保存的 API Key，或重新认证 OAuth。
# list all saved keys
aivo keys
# quickly add a key with options
aivo keys add --base-url https://openrouter.ai/api --key sk-xxx
# activate a key to use
aivo keys use
aivo keys use mykey
# print saved data of a key
aivo keys cat
# edit a saved key
aivo keys edit
# health-check
aivo keys ping
# OAuth re-login / rotate a key
aivo keys reauth
# for more options
aivo keys --help
为 Coding Agent 自由搭配任意服务商与模型。aivo 参数之外的所有额外参数均会透传给底层工具。
aivo claude 使用 -k 指定已保存的 API Key；省略值可打开 API Key 选择器。同时使用不带值的 -k 和 -m，可以一次选择两者。
aivo claude -k openrouter
aivo claude -k copilot
aivo claude -k
使用 -m 指定模型；省略值可打开模型选择器。应用模型后，aivo claude 会在下次运行时沿用该模型。
aivo claude -m moonshotai/kimi-k2.5
aivo claude -m
各槽位独立模型 Claude Code 支持同会话多模型编排，涵盖 haiku/sonnet/opus/fable 槽位及 Subagent 覆盖项。每个槽位均可独立指定模型；参数缺省时自动弹出选择器。
aivo claude --sonnet-model deepseek-v4-pro --haiku-model deepseek-v4-flash
aivo claude --fable-model gpt-5.4 --subagent-model claude-haiku-4-5
# open the picker for one slot
aivo claude --opus-model
aivo codex 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo codex -k vercel
aivo codex -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo codex -m xiaomi/mimo-v2-pro
aivo codex -m
各槽位独立模型 Codex 支持同会话多模型编排，涵盖主模型以及 review 和 subagent 覆盖项。每个槽位均可独立指定模型；参数缺省时自动弹出选择器。
aivo codex --review-model gpt-5.3-codex --subagent-model claude-haiku-4-5
# open the picker for one slot
aivo codex --review-model
Codex 桌面端（实验性） 复用同一套后端启动原生 Codex。应用内置的模型选择器仅显示以 gpt- 或 claude- 开头的名称；其他模型仍可正常驱动，仅不显示在列表中。
aivo codex-app
aivo codex-app -k aivo pi 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo pi -k cursor
aivo pi -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo pi -m composer-2.5
aivo pi -m
透明模式 由于 Pi 原生支持多种上游协议，aivo 默认通过本地路由器转发并标准化数据流。使用 --transparent 可将 URL 与对应 API 类型直接交给 Pi 建立直连。
aivo pi --transparent -k openrouter
aivo grok 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo grok -k openrouter
aivo grok -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo grok -m gpt-5.4
aivo grok -m
aivo gemini 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo gemini -k google
aivo gemini -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo gemini -m gemini-2.5-pro
aivo gemini -m
aivo opencode 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo opencode -k openrouter
aivo opencode -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo opencode -m z-ai/glm-4.7
aivo opencode -m
请先安装插件Amp 通过独立插件提供支持。安装后即可像其他 Coding Agent 一样运行。
aivo plugins install github:yuanchuan/aivo-amp
aivo amp 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo amp -k openrouter
aivo amp -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo amp -m gpt-5.4
aivo amp -m
各模式独立模型Amp 可在 rush、smart、deep 和 large 模式之间切换。每种模式都能指定不同的模型；模式参数不带值时，会打开对应的模型选择器。
aivo amp --smart-model claude-sonnet-4.6 --rush-model claude-haiku-4-5
aivo amp --deep-model gpt-5.4-thinking --large-model deepseek-v4-pro
# pin the starting mode, or omit the value to open the mode picker
aivo amp --mode deep
aivo amp --mode
请先安装插件omp 通过独立插件提供支持。安装后即可像其他 Coding Agent 一样运行。
aivo plugins install github:yuanchuan/aivo-omp
aivo omp 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo omp -k openrouter
aivo omp -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo omp -m deepseek-v4-pro
aivo omp -m
请先安装插件GitHub Copilot CLI 通过独立插件提供支持。安装后即可像其他 Coding Agent 一样运行。
aivo plugins install github:yuanchuan/aivo-copilot
aivo copilot 使用 -k 指定已保存的 API Key；省略值可打开选择器。
aivo copilot -k openrouter
aivo copilot -k
使用 -m 指定模型；省略值可打开模型选择器。
aivo copilot -m claude-sonnet-4.6
aivo copilot -m
不指定工具名时，aivo run 会打开 Coding Agent 和插件的交互式选择器，默认选中上次使用的工具。
aivo run
为 Coding Agent 及其常用参数创建启动别名，之后可通过 aivo <name>（或完整形式 aivo run <name>）一键启动。运行时传入的参数会覆盖已保存的参数，轻松复用槽位模型配置。
# Claude Code with separate models per slot
aivo alias work claude -k openrouter \
--opus-model deepseek/deepseek-v4-pro \
--sonnet-model deepseek/deepseek-v4-flash \
--haiku-model deepseek/deepseek-v4-flash \
# Amp with separate models per mode, pinned to deep mode
aivo alias task amp -k openrouter \
--smart-model openai/gpt-5.5 \
--deep-model anthropic/claude-opus-4.7 \
--rush-model openai/gpt-5.4 \
--large-model deepseek/deepseek-v4-pro
# run them
aivo work
aivo task
aivo code 是内置于终端的完整 Coding Agent。它能够读取项目、编辑文件、运行命令并验证结果；可使用任意已保存的服务商或本地 GGUF，并支持长会话、Skills、MCP 与 Subagent。
/plan 先只读调查再等待批准；/goal 会持续工作直至完成。 打开交互式 Agent、启动时直接给出第一个任务、选择 Key 与模型，或从上次中断的位置继续。
# start the interactive coding agent
aivo code
# start with a task, key, or model
aivo code "fix the failing login test"
aivo code -k openrouter -m anthropic/claude-sonnet-4.6
# resume your latest session
aivo code --resume last
Plan 模式会先以只读方式调查，待你批准方案后再实现。Goal 模式会围绕目标自主持续工作；Rewind 可将对话和文件修改一起恢复到更早的轮次。
# investigate read-only, then approve the plan to build
/plan redesign the authentication flow
# keep working autonomously until the objective is done
/goal make the test suite pass
# restore the project to an earlier turn
/rewind
使用 -e 可在没有 TUI 的情况下运行同一套工具调用 Agent。修改代码后会执行自动识别的项目检查，并将失败结果交还给 Agent 继续修复；也可限制步骤数、Token 与成本。
# full agent loop: inspect, edit, run, and verify
aivo code -e "fix the failing tests"
# bound unattended work and return a scriptable result
aivo code -e "audit dependencies" \
--max-steps 40 --max-cost 2 \
--output-format json
# continue a prior headless run
aivo code -e "now fix what you found" --resume last
继续已保存的会话、附加文本或图片供 Agent 读取，或创建实时脱敏的会话查看 URL。
# resume a past session
aivo code --resume
# attach files or images for the agent to read
aivo code --attach README.md --attach screenshot.png
# share a live, redacted view of the session
aivo code --share
对于无需工具的问题，可使用 -p 发送一次普通提示词，或将命令输出通过管道传入 aivo，收到答案后立即退出。
aivo "explain this regex"
git diff | aivo -p "Write a commit message"
cat error.log | aivo -p "Find the root cause"
配置服务商与 API Key 后，即可使用 models 命令查看其提供的可用模型。多数服务商通过 API 提供模型列表，aivo 按需获取并自动缓存供后续使用。
获取当前 API Key 对应的模型列表并应用缓存。支持通过 -s 筛选或使用 -k 切换 API Key。
# active key's models, or pick one
aivo models
aivo models -k openrouter
# filter by name
aivo models -s free
aivo models -k openrouter -s claude
# force refresh the cached list
aivo models --refresh
--json 会输出 aivo 标准化后的模型目录供脚本使用，而非上游原始响应。可通过管道传给 jq 灵活筛选。
aivo models --json
aivo models -k openrouter --json | jq
模型名称过长时可设置简短别名。凡接受 -m/--model 之处均支持模型别名。
aivo alias fast=claude-haiku-4-5
aivo alias mimo xiaomi/mimo-v2-pro
# use it
aivo claude -m fast
aivo code -k vercel -m mimo
# list and remove
aivo alias
aivo alias rm fast
直接运行 Hugging Face 仓库或本地 .gguf 文件中的开源模型。凡接受模型标识之处，均支持 hf: 前缀、完整 HF URL 或本地文件路径，包括 aivo code、Coding Agent 的 -m 以及 aivo 快捷命令。
将 aivo、aivo code 或 Coding Agent 的 -m 指向仓库或本地 .gguf 文件。首次引用将自动拉取缓存并拉起本地服务。
aivo hf:Qwen/Qwen2.5-0.5B-Instruct-GGUF
aivo https://huggingface.co/allenai/Olmo-3-1025-7B
# a local .gguf works too
aivo code -m ./Qwen2.5-0.5B-Instruct-Q4_K_M.gguf
GGUF 仓库通常发布多种量化版本。在末尾追加 :<quant>（如 Q5_K_M、Q4_K_M）可指定具体版本；缺省时 aivo 默认选用 Q4_K_M（或最接近的可用版本）。
aivo code -m hf:bartowski/Llama-3.2-3B-Instruct-GGUF:Q5_K_M
aivo claude -m hf:bartowski/Llama-3.2-3B-Instruct-GGUF:Q4_K_M
aivo 会为内置的 llama-server 预设合理的调优参数。可通过配置对应环境变量进行覆盖。
AIVO_LLAMA_CTX=16384 # smaller context on a low-RAM machine
AIVO_LLAMA_NGL=20 # GPU layers (AIVO_GPU=cpu to stay on CPU)
AIVO_LLAMA_ARGS='--temp 0.1' # extra llama-server flags
AIVO_LLAMA_MMPROJ=off # skip the vision projector
AIVO_LLAMA_DRAFT=off # skip the draft model
凡接受 -m/--model 处均可传入 hf:。配合 Claude Code 与 Amp 的槽位参数，可在同一次会话中混用本地与远程模型。
aivo claude -m hf:Qwen/Qwen2.5-0.5B-Instruct-GGUF
aivo pi -m hf:Qwen/Qwen2.5-0.5B-Instruct-GGUF
# mix: remote opus, local sonnet
aivo claude \
--opus-model claude-opus-4.7 \
--sonnet-model hf:Qwen/Qwen2.5-0.5B-Instruct-GGUF
单独传入 hf: 即可唤起本地缓存交互选择器，无需重复输入完整的仓库路径。
aivo code hf:
aivo claude hf:
aivo hf 列出所有已缓存仓库；--verbose 可展开查看各仓库下下载的具体量化版本。
# list cached repos
aivo hf
# pre-pull a model (handy before going offline)
aivo hf pull hf:Qwen/Qwen2.5-0.5B-Instruct-GGUF
# delete one quant or a whole repo
aivo hf rm <repo> --quant Q5_K_M
aivo hf rm <repo> --all -y
# wipe the whole cache
aivo hf clean -y
将当前激活的服务商转化为本地标准 OpenAI 兼容端点。VS Code 插件、脚本或任何兼容客户端均可即插即用。
默认监听 localhost。需要从局域网访问或绑定其他地址时，可修改端口或 host。
aivo serve
aivo serve --port 8080
aivo serve --host 0.0.0.0
如果请求遭遇限流（429）或服务端错误（5xx），aivo 会自动切换至下一个已保存的 API Key 进行重试。
aivo serve --failover
完整记录每个请求和响应。可通过管道传给 jq 以获得易读输出，亦可写入文件。
aivo serve --log | jq .
aivo serve --log /tmp/requests.jsonl
要求客户端携带 Token、为浏览器工具启用 CORS，或缩短上游超时时间。
aivo serve --auth-token
aivo serve --auth-token my-secret
aivo serve --cors
aivo serve --timeout 60
可将任意 OpenAI 兼容客户端指向本地端点；curl 可用于快速验证服务是否正常。
curl http://127.0.0.1:24860/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "hello"}]}' 统一查看 aivo 自身事件（code、run、serve）、原生 CLI 会话（claude、codex、gemini、pi、opencode）和 Amp 线程。数据直接读取各工具磁盘会话文件及 aivo 本地 SQLite，默认仅显示当前项目。
默认显示当前项目的记录，并按时间倒序排列。传入 --all 可包含本机所有项目。
# recent activity in the current project
aivo logs
# every project on this machine
aivo logs --all
可按来源、模型、API Key、时间或文本筛选。--errors 仅显示失败记录。
aivo logs --by code -n 5
aivo logs --by claude --errors
aivo logs --by native
aivo logs --model glm-4.7
aivo logs -s "rate limit"
aivo logs --since 24h
aivo logs --json
通过安全隧道生成会话分享链接，方便向同事展示 Bug 复现、Agent 会话轨迹或模型评测结果。
中转服务器仅负责在浏览器与本地之间建立安全隧道转发，云端不会保留任何会话数据。
# pick a session in the current project
aivo logs share
# share a specific row by id prefix
aivo logs share 1335c631
# pick from every project on this machine
aivo logs share --all
# follow updates and open in the browser
aivo logs share --open
# skip redaction (be sure)
aivo logs share --no-redact
直接解析各工具的原生会话数据，统一汇总并呈现跨 Agent、跨模型的 Token 消耗看板。
aivo stats
aivo stats claude
aivo stats code
支持输出原始数值、按服务商筛选、设置时间范围，以及绕过缓存，便于脚本处理。
# raw numbers for scripts
aivo stats -n
# filter by provider
aivo stats -s openrouter
# last N units (m, h, d, w)
aivo stats --since 7d
aivo stats claude --since 24h
# show all models
aivo stats -a
# bypass cache
aivo stats -r
典型的 aivo stats 汇总输出示例。
$ aivo stats
────────────────────────────────────────────────────
408M tokens · 14B cached · 5.0K sessions · 77 models
By tool sessions tokens
claude 4.2K 295M ████████████████████
codex 256 87M █████▉
opencode 166 10M ▊
code 91 8.0M ▌
gemini 204 4.2M ▎
pi 85 3.8M ▎
By model tokens
gpt-5.4 75M ████████████████████
minimax-m2.5 63M ████████████████▊
claude-sonnet-4.6 53M ██████████████▏
claude-opus-4.6 40M ██████████▋
minimax-m2.7 38M ██████████▏
claude-opus-4.7 31M ████████▏
laguna-xs-2.1 22M █████▉
claude-haiku-4-5-20251001 14M ███▉
kimi-k2.5:cloud 11M ██▉
claude-sonnet-4.5 6.6M █▊
gpt-5.3-codex 6.1M █▋
glm-4.7-free 6.0M █▋
glm-4.7 5.0M █▍
mercury-2 4.3M █▏
deepseek-v4-flash 3.7M █
gpt-5.5 3.6M █
kimi-k2.5 2.0M ▌
starter 1.8M ▌
gpt-5.1-codex 1.5M ▍
kat-coder-pro-v1 1.4M ▍
others (57 models) 9.8M ██▋ 无需配置服务商即可试用 aivo。aivo-starter 内置了 3 个用于学习和测试的模型，让你在添加自己的 API Key 前先体验 aivo 的使用方式。
aivo/starter 默认模型 · aivo 托管 日常通用默认模型，由 aivo 动态调度，适合各类常规编码与对话任务。 deepseek/deepseek-v4-flash DeepSeek V4 Flash · official API DeepSeek 官方的高速高吞吐前沿模型。 poolside/laguna-s-2.1 Laguna S 2.1 · Poolside Poolside 第二代 S 规格 Coding Agent 模型。 安装 aivo 后即可直接使用。
aivo "tell me a short story"
aivo code 将设备关联到账号，即可获得入门池更高的每日额度。
aivo account login
aivo account usage 入门池的每日预算有限，主要用于交互式 Coding Agent 会话。如需常规或自动化使用，请添加自己的 API Key。
aivo update 会检测 aivo 是通过 Homebrew 还是安装脚本安装，并采用相应方式更新。更新失败时会自动回滚；如果新版本运行异常，也可手动回滚。
aivo update
# force update even if installed via a package manager
aivo update --force
# restore the previous version from the last backup
aivo update --rollback
模型限制数据来自 models.dev，并内置于每个发行版中。--sync-model-data 可在版本发布之间刷新这份快照，而不更新二进制文件。
aivo update --sync-model-data