{"id":46097925,"url":"https://github.com/yuanchuan/aivo","last_synced_at":"2026-04-01T22:53:04.271Z","repository":{"id":340931941,"uuid":"1167252967","full_name":"yuanchuan/aivo","owner":"yuanchuan","description":"Unified key management and protocol bridge tool for Claude Code, Codex, and Gemini.","archived":false,"fork":false,"pushed_at":"2026-03-08T07:54:22.000Z","size":544,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-08T09:57:48.737Z","etag":null,"topics":["claude-code","codex","gemini-cli","github-copilot","openrouter","vercel-ai-gateway"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yuanchuan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-26T05:08:24.000Z","updated_at":"2026-03-08T07:54:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yuanchuan/aivo","commit_stats":null,"previous_names":["yuanchuan/aivo"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/yuanchuan/aivo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuanchuan%2Faivo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuanchuan%2Faivo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuanchuan%2Faivo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuanchuan%2Faivo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuanchuan","download_url":"https://codeload.github.com/yuanchuan/aivo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuanchuan%2Faivo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30464996,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T06:34:02.089Z","status":"ssl_error","status_checked_at":"2026-03-13T06:33:49.182Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex","gemini-cli","github-copilot","openrouter","vercel-ai-gateway"],"created_at":"2026-03-01T19:07:13.165Z","updated_at":"2026-04-01T22:53:03.663Z","avatar_url":"https://github.com/yuanchuan.png","language":"Rust","readme":"# aivo\n\nA lightweight CLI for managing API keys and running Claude Code, Codex, Gemini, OpenCode, and Pi CLI across providers.\n\n## What it does\n\n- Securely manages multiple API keys for different providers.\n- Runs `claude`, `codex`, `gemini`, `opencode`, and `pi` CLI tools seamlessly.\n- Provides a simple chat TUI and a one-shot `-x` mode.\n- Can expose the active provider as a local OpenAI-compatible server.\n\n## Install\n\nHomebrew:\n\n```bash\nbrew install yuanchuan/tap/aivo\n```\n\nInstall script:\n\n```bash\ncurl -fsSL https://getaivo.dev/install.sh | bash\n```\n\nVia npm (only recommended for windows users):\n\n```bash\nnpm install -g @yuanchuan/aivo\n```\n\nOr download a binary from [GitHub Releases](https://github.com/yuanchuan/aivo/releases).\n\n\n## Quick Start\n\naivo ships with a free built-in provider (`aivo/starter`) that is activated automatically on first run — no API key needed:\n\n```bash\naivo -x hello\naivo claude\n```\n\nAdd your own provider key for access to more models:\n\n```bash\n# 1) Add a provider key (OpenRouter, Vercel AI Gateway, etc.)\naivo keys add\n\n# 2) Launch your tool\naivo claude\n\n# 3) Optionally pin a model\naivo claude --model moonshotai/kimi-k2.5\n```\n\nUse your GitHub Copilot subscription.\n\n```bash\naivo keys add copilot\naivo claude\n```\n\nUse local models via Ollama.\n\n```bash\naivo keys add ollama\n\n# auto pull the model if not present\naivo claude --model llama3.2\n```\n\n## Commands\n\n| Command | Description |\n| ------- | ----------- |\n| [run](#run) | Launch an AI tool (claude, codex, gemini, opencode, pi) |\n| [chat](#chat) | Interactive chat TUI or one-shot `-x` mode |\n| [serve](#serve) | Local OpenAI-compatible API server |\n| [keys](#keys) | Manage API keys (add, use, rm, cat, edit, ping) |\n| [models](#models) | List available models from the active provider |\n| [alias](#alias) | Create short names for models |\n| [info](#info) | Show system info, keys, tools, and directory state |\n| [logs](#logs) | Query local SQLite logs for chat, run, and serve |\n| [stats](#stats) | Show usage statistics |\n| [update](#update) | Update to the latest version |\n\n## run\n\nLaunch an AI tool with the active provider key. All extra arguments are passed through to the underlying tool.\n\nSupported tools:\n\n- `claude` [Claude Code](https://github.com/anthropics/claude-code)\n- `codex` [Codex](https://github.com/openai/codex)\n- `gemini` [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n- `opencode` [OpenCode](https://github.com/anomalyco/opencode)\n- `pi` [Pi Coding Agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent)\n\nThe `run` keyword is optional — tool names work directly as shortcuts, so `aivo claude` is equivalent to `aivo run claude`.\n\n```bash\naivo run claude\naivo claude \"fix the login bug\"\naivo claude --dangerously-skip-permissions\naivo claude --resume 16354407-050e-4447-a068-4db222ff841\n```\n\n#### `--model, -m`\n\nPick a model for one run, or omit the value to open the model picker:\n\n```bash\naivo claude --model moonshotai/kimi-k2.5\naivo claude --model                      # opens model picker\naivo claude -m                           # short form\n```\n\n#### `--key, -k`\n\nUse a different saved key without changing the active one:\n\n```bash\naivo claude --key openrouter\naivo claude --key copilot\naivo claude --key                        # opens key picker\n```\n\n#### `--refresh, -r`\n\nBypass cache and fetch a fresh model list for the picker:\n\n```bash\naivo claude -r\n```\n\n#### `--dry-run`\n\nPreview the resolved command and environment without launching:\n\n```bash\naivo claude --dry-run\n```\n\n#### `--env, -e`\n\nInject extra environment variables into the child process:\n\n```bash\naivo claude --env BASH_DEFAULT_TIMEOUT_MS=60000\n```\n\n#### `aivo run`\n\nWithout a tool name, `aivo run` uses the interactive start flow, which remembers your key + tool selection per directory,\nso next time you run `aivo run` in the same directory, it will skip the selection step and go straight to launching the tool.\n\n```bash\naivo run\n```\n\n## chat\n\n`aivo chat` starts the full-screen chat UI.\n\n```bash\naivo chat\n```\n\n#### `--model, -m`\n\nSpecify or change the chat model. Omit the value to open the model picker. The selected model is remembered per saved key.\n\n```bash\naivo chat --model gpt-4o\naivo chat -m claude-sonnet-4-5\naivo chat --model                        # opens model picker\n```\n\n#### `--key, -k`\n\nUse a different saved key for this chat session:\n\n```bash\naivo chat --key openrouter\naivo chat -k                             # opens key picker\n```\n\n#### `--execute, -x`\n\nSend a single prompt and exit. When `-x` has a message, piped stdin is appended as context. When `-x` has no message, the entire stdin becomes the prompt.\n\n```bash\naivo chat -x \"Summarize this repository\"\ngit diff | aivo -x \"Write a one-line commit message\"\ncat error.log | aivo -x\naivo -x                                 # type interactively, Ctrl-D to send\n```\n\n`aivo -x` is a shortcut for `aivo chat -x`.\n\n#### `--attach`\n\nAttach text files or images to the next message (repeatable):\n\n```bash\naivo chat --attach README.md --attach screenshot.png\n```\n\n#### `--refresh, -r`\n\nBypass the model cache when opening the model picker:\n\n```bash\naivo chat -r\n```\n\n#### Slash commands\n\nInside the chat TUI:\n\n| Command | Description |\n| ------- | ----------- |\n| `/new` | Start a fresh chat with the current key and model |\n| `/resume [query]` | Resume a saved chat from this directory |\n| `/model [name]` | Switch the current chat model |\n| `/key [id\\|name]` | Switch to another saved key for this chat |\n| `/attach \u003cpath\u003e` | Attach a text file or image to the next message |\n| `/detach \u003cn\u003e` | Remove one queued attachment by number |\n| `/clear` | Clear queued attachments from the composer |\n| `/help` | Open command help |\n| `/exit` | Leave chat |\n| `//message` | Send a literal leading slash |\n\n\n## serve\n\n`aivo serve` exposes the active provider as a local OpenAI-compatible endpoint. Handy for scripts and tools that already speak the OpenAI API.\n\n```bash\naivo serve                               # http://127.0.0.1:24860\n```\n\n#### `--port, -p`\n\nListen on a custom port (default: 24860):\n\n```bash\naivo serve --port 8080\naivo serve -p 8080\n```\n\n#### `--host`\n\nBind to a specific address (default: 127.0.0.1):\n\n```bash\naivo serve --host 0.0.0.0               # expose on all interfaces\n```\n\n#### `--key, -k`\n\nUse a different saved key:\n\n```bash\naivo serve --key openrouter\naivo serve -k                            # opens key picker\n```\n\n#### `--log`\n\nEnable request logging. Logs to stdout by default, or to a file if a path is given:\n\n```bash\naivo serve --log | jq .                  # JSONL to stdout\naivo serve --log /tmp/requests.jsonl     # JSONL to file\n```\n\n#### `--failover`\n\nEnable multi-key failover on 429/5xx errors. Automatically retries with other saved keys:\n\n```bash\naivo serve --failover\n```\n\n#### `--cors`\n\nEnable CORS headers for browser-based clients:\n\n```bash\naivo serve --cors\n```\n\n#### `--timeout`\n\nUpstream request timeout in seconds (default: 300, 0 = no timeout):\n\n```bash\naivo serve --timeout 60\n```\n\n#### `--auth-token`\n\nRequire a bearer token. Auto-generated if no value given:\n\n```bash\naivo serve --auth-token                  # auto-generated token\naivo serve --auth-token my-secret        # specific token\n```\n\n## keys\n\nManage saved API keys. Keys are stored locally and encrypted in the user config directory.\n\n```bash\naivo keys                                # list all keys\n```\n\n#### `keys add`\n\nAdd a new provider key. Interactive by default, or pass `--name`, `--base-url`, and `--key` for scripted setup:\n\n```bash\naivo keys add\naivo keys add --name openrouter --base-url https://openrouter.ai/api/v1 --key sk-xxx\naivo keys add --name groq --base-url https://api.groq.com/openai/v1 --key sk-xxx\naivo keys add --name deepseek --base-url https://api.deepseek.com/v1 --key sk-xxx\n```\n\nAny endpoint that speaks a supported protocol can be saved — you are not limited to the providers above.\n\nThree special names skip the base-url/key prompts:\n\n- **`copilot`** — uses your GitHub Copilot subscription via OAuth device flow\n- **`ollama`** — connects to a local Ollama instance (auto-starts if needed)\n- **`aivo-starter`** — free built-in provider (auto-created on first run, re-add if removed)\n\n```bash\naivo keys add copilot\naivo keys add ollama\naivo keys add aivo-starter\n```\n\n#### `keys use`\n\nSwitch the active key by name or ID:\n\n```bash\naivo keys use openrouter\naivo keys use                            # opens key picker\naivo use openrouter                      # shortcut\n```\n\n#### `keys cat`\n\nPrint the decrypted key details:\n\n```bash\naivo keys cat\naivo keys cat openrouter\n```\n\n#### `keys edit`\n\nEdit a saved key interactively:\n\n```bash\naivo keys edit\naivo keys edit openrouter\n```\n\n#### `keys rm`\n\nRemove a saved key:\n\n```bash\naivo keys rm openrouter\n```\n\n#### `keys ping`\n\nHealth-check the active key, or all keys:\n\n```bash\naivo keys ping\naivo keys ping --all\naivo ping                                # shortcut\n```\n\n## models\n\nList models available from the active provider. Model lists are cached for one hour.\n\n```bash\naivo models\n```\n\n#### `--refresh, -r`\n\nBypass the cache and fetch a fresh model list:\n\n```bash\naivo models --refresh\n```\n\n#### `--key, -k`\n\nList models for a different saved key:\n\n```bash\naivo models --key openrouter\n```\n\n#### `--search, -s`\n\nFilter models by substring:\n\n```bash\naivo models -s sonnet\n```\n\n## alias\n\nCreate short names for models. Aliases work anywhere a model name is accepted.\n\n```bash\naivo alias                               # list all aliases\n```\n\n#### Create an alias\n\n```bash\naivo alias fast=claude-haiku-4-5\naivo alias best claude-sonnet-4-6        # alternative syntax\n```\n\nThen use it in place of the full model name:\n\n```bash\naivo claude -m fast\naivo chat -m best\n```\n\n#### Remove an alias\n\n```bash\naivo alias rm fast\n```\n\n## info\n\nShow a compact overview of saved keys, installed tools, the remembered tool/model for the current directory, and the cached model count for the active key. (`ls` is accepted as an alias.)\n\n```bash\naivo info\n```\n\n#### `--ping`\n\nAlso health-check all keys:\n\n```bash\naivo info --ping\n```\n\n## logs\n\nQuery the local SQLite log database used by aivo chat, run, and serve. Chat logs include turn content and token usage. `run` logs record launch metadata only. `serve` logs record request metadata only.\n\nBy default, `aivo logs` prints entries in chronological order like traditional system logs. Use `--latest-first` to show newest entries first.\n\n```bash\naivo logs\n```\n\n#### `show \u003cid\u003e`\n\nShow one entry in detail:\n\n```bash\naivo logs show 7m2q8k4v9cpr\n```\n\n#### `path`\n\nPrint the SQLite database path:\n\n```bash\naivo logs path\n```\n\n#### `status`\n\nShow entry counts and database size:\n\n```bash\naivo logs status\n```\n\n#### Quick search\n\nA bare word is treated as a search query:\n\n```bash\naivo logs claude\naivo logs \"rate limit\"\n```\n\n#### Filters\n\n```bash\naivo logs --source chat -n 5\naivo logs --tool claude --errors\naivo logs -s \"rate limit\"\naivo logs --model sonnet\naivo logs --key openrouter\naivo logs --cwd /path/to/project\naivo logs --since \"2025-01-01\" --until \"2025-02-01\"\naivo logs --json\naivo logs --latest-first\n```\n\n#### Live watch\n\nPoll and refresh matching logs continuously:\n\n```bash\naivo logs --source run --watch\naivo logs --watch --interval 2\naivo logs --watch --jsonl\n```\n\n## stats\n\nShow usage statistics across all tools. Aggregates token counts from aivo chat, Claude Code, Codex, Gemini, OpenCode, and Pi by reading each tool's native data files. Per-file caching makes subsequent runs fast.\n\n```bash\naivo stats\n```\n\n#### Positional argument\n\nShow stats for a single tool:\n\n```bash\naivo stats claude\naivo stats chat\n```\n\n#### `--numbers, -n`\n\nShow exact numbers instead of human-readable approximations:\n\n```bash\naivo stats -n\n```\n\n#### `--search, -s`\n\nFilter by key, model, or tool name:\n\n```bash\naivo stats -s openrouter\n```\n\n#### `--refresh, -r`\n\nBypass cache and re-read all data files:\n\n```bash\naivo stats -r\n```\n\n#### `--all, -a`\n\nShow all models (default: top 20, rest grouped as \"others\"):\n\n```bash\naivo stats -a\n```\n\n#### `--top-sessions`\n\nShow the heaviest native session files:\n\n```bash\naivo stats --top-sessions\n```\n\n## update\n\nUpdate to the latest version. Delegates to Homebrew or npm when installed by those package managers.\n\n```bash\naivo update\n```\n\n#### `--force`\n\nForce update even if installed via a package manager:\n\n```bash\naivo update --force\n```\n\n#### `--rollback`\n\nRestore the previous version from the last update backup:\n\n```bash\naivo update --rollback\n```\n\n## Development\n\n```bash\nmake build\nmake build-debug\nmake check\nmake test\nmake clippy\nmake build-release\n```\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuanchuan%2Faivo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuanchuan%2Faivo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuanchuan%2Faivo/lists"}