multiai
v0.7.0
Published
Route multiple AI CLIs (Claude Code, Codex, OpenCode) with isolated env profiles — native Go binary, SHA256-verified download, embedded Anthropic-to-OpenAI bridge (free NVIDIA models in Claude Code)
Maintainers
Readme
multiai
Route multiple AI CLIs (Claude Code, Codex CLI, OpenCode) through isolated environment profiles. One command, 37+ provider profiles, API keys kept in your OS credential store.
The published npm package installs the native Go binary for Windows, macOS, and Linux.
Requires Node.js 24.14 or newer. Older environments can use the standalone Go binary from GitHub Releases instead.
Quick install
npx --yes --allow-scripts=multiai multiai@latest install
multiaiFor a one-off run without a global install:
npx --yes --allow-scripts=multiai multiai@latestWhat npm installation does
- Downloads the archive for your platform from the matching GitHub release
(
windows/amd64,darwin/amd64+arm64,linux/amd64+arm64). - Verifies its SHA256 against the release
checksums.txt— a mismatch aborts the install before anything is extracted. - Installs the binary inside the package and exposes it through a Node shim
(
multiaion your PATH).
On Windows, the explicit install command discovers npm's global prefix,
verifies that multiai.cmd exists, and adds that directory to the current
user's persistent PATH when needed. The operation is idempotent, requires no
administrator rights, and never uses setx. Open a new terminal after the
first installation; a child process cannot rewrite the current shell's
environment.
This PATH automation belongs to the explicit npx ... multiai install
workflow above. A raw npm install --global multiai still relies on npm's
global prefix already being configured in PATH.
The checksums.txt itself is signed with Cosign (keyless, GitHub Actions
OIDC). To verify the whole chain manually:
cosign verify-blob \
--bundle checksums.txt.sigstore.json \
--certificate-identity-regexp 'https://github.com/lrochetta/multiai' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
checksums.txt
sha256sum --check --ignore-missing checksums.txtThe npm installer does not run cosign for you (it only checks SHA256); run the commands above if you want signature-level assurance.
Environment variables
| Variable | Effect |
|---|---|
| MULTIAI_SKIP_DOWNLOAD=1 | Skip the binary download (CI, offline). |
| MULTIAI_INSTALL_DIR=path | Also copy the verified binary to path. |
| MULTIAI_SKIP_PATH_UPDATE=1 | Do not update the Windows user PATH (managed environments). |
Usage
multiai # interactive menu
multiai launch -p ds
multiai list --json
multiai config
multiai helpFull documentation: https://github.com/lrochetta/multiai
License
MIT
