CLI reference
Updated
Your coding agent runs these for you. Run runinfra help for the exact options in your version.
| Connection | Value |
|---|---|
| Control site | https://runinfra.ai |
| Command | runinfra |
| Sign-in | Approve the device code in your browser. Keep your API key out of agent chat. |
| Billing | The existing funding rules of your open-model account. |
Use the model ID from your setup plan.
Replace MODEL_ID with an available id from Open models; read current capabilities, limits and prices from GET /v1/models.
Coding plans are retired. New customers have been unable to buy them since 2026-11-03. Existing holders keep their current plan until its paid period ends, subject to the plan's payment and eligibility conditions. runinfra plan buy is unavailable. Workspaces without a current plan use credits. Installed CLIs still run runinfra plan, which shows your plan until it ends.
Install
Node.js 22 or newer:
Or Python 3.8 or newer:
Check with runinfra update --check, then update with runinfra update.
Commands
| Task | Command |
|---|---|
| Sign in | runinfra login |
| Check sign-in | runinfra whoami |
| Find agents | runinfra agents |
| Review a connection | runinfra connect <agent> --json |
| Apply the approved connection | Repeat with --yes |
| Undo setup | runinfra disconnect <name> |
| Diagnose connections | runinfra doctor |
| List models | runinfra models --harness <agent> |
| Change the starting model | runinfra models set <name> MODEL_ID |
| Refresh models | runinfra models sync [name] |
| List key prefixes | runinfra keys |
| Rotate a key | runinfra keys rotate <name> |
| Revoke a key | runinfra keys revoke --id <keyId> |
| Set a $10 monthly cap | runinfra keys cap <name> 10 (use none to remove) |
| Check plan status | runinfra plan |
| Open plan settings | runinfra plan settings |
| Read your account | runinfra account |
| Sign out | runinfra logout |
| Update | runinfra update |
| Read help | runinfra help |
Use the separate command's name for model, key and disconnect commands. Disconnect does not sign this computer out.
Connect options
| Option | Meaning |
|---|---|
--funding plan | Current coding plan first, then credits under your workspace policy. |
--funding credits | Pay as you go; keeps paying from credits while a current plan remains active. |
--in-place | Use the open-models service inside Claude Code or Codex until you disconnect. |
--name <name> | Name a separate command. |
--model MODEL_ID | Choose a starting model. |
--key-source file|env | Choose where the key lives. |
--preview | Allow preview setup, including saved settings and a paid check. |
--yes | Approve the same unused review. |
Omit --funding when no Coding plan can pay. See Choose how to pay.
Good to know
--json prints one document on stdout.
File and key changes need a reviewed plan and approval. Scripts exit 8 until you repeat with --yes.
Only connect, keys rotate, doctor --verify and models sync --verify send paid checks.
Files live in ~/.config/runinfra ($XDG_CONFIG_HOME/runinfra when set; %LOCALAPPDATA%\runinfra on Windows). RUNINFRA_CONFIG_DIR changes that path. Only step-by-step terminal setup adds a separate command's folder to PATH, after your yes.
Exit codes
| Code | Meaning |
|---|---|
0 | Success. |
1 | Unexpected internal error. |
2 | Bad usage, unsupported runtime, or local precheck. |
3 | Not signed in, denied, expired, revoked, or auth_pending (awaiting approval). |
4 | Entitlement or plan refused, or the requested agent, key or resource was not found. |
5 | Network, server, readiness, or requested measurement unavailable. |
6 | Integrity or configuration verification failure. |
7 | Local preparation failed or storage is unavailable. |
8 | Consent required before the command may continue. |
9 | Consent was refused. |
130 | Interrupted. |
Terminal app
Run runinfra in your terminal. Pick an agent it found, then a separate command you can rename or Inside Claude Code or Codex. Pick one you already set up to update its models, set it up again, or remove the open-models service. Sign in through your browser, read the short review, and press Enter. The open-models service then offers to start the agent. The same screens manage keys and sign-out.