voltsai

Volts Consulting AI gateway CLI. Single-file Node.js installer that configures your IDEs (Claude Code, Cursor, Cline, Roo Code, VS Code Claude extension) to talk to the Volts LiteLLM proxy.

The CLI is public and has no secrets. It downloads from npm, asks for an API key, and writes your IDE settings. The API key is verified against the Volts proxy before being saved.

Install & use

# Configure your IDEs (interactive wizard)
npx voltsai setup

# Or set env vars in your shell instead
npx voltsai login sk-volts-YOUR-KEY
eval "$(npx voltsai shell-init bash)" # bash
eval "$(npx voltsai shell-init zsh)" # zsh
# PowerShell:
npx voltsai env powershell | Out-String | Invoke-Expression

Commands

voltsai login [key] Save & verify API key
voltsai logout Remove the API key from the active profile
voltsai whoami Show the active profile + key info
voltsai status Health check + key validity
voltsai use <profile> Switch active profile
voltsai profiles List configured profiles
voltsai env [shell] Print env vars (bash|zsh|powershell|fish)
voltsai shell-init [shell] Print eval-line for ~/.bashrc etc.
voltsai setup Interactive wizard — configure IDEs
voltsai uninstall Remove IDE configs and clear stored credentials
voltsai models List models available on the proxy
voltsai --version Print version
voltsai --help Show this help

Configuration storage

Multi-profile config lives at ~/.voltsai/config.json (mode 0600):

{
 "active": "default",
 "profiles": {
 "default": {
 "name": "default",
 "proxyUrl": "https://ai-api.volts-consulting.com",
 "apiKey": "sk-volts-...",
 "savedAt": "2026-06-19T22:45:00.000Z"
 }
 }
}

Switch profiles with voltsai use <name>. Useful for keeping work and personal keys separate.

Requirements

• Node.js 18 or newer (Node 20+ recommended)

License

MIT