When does Enter approve?

Read Review to the end and resolve any blockers. When approval is available, Enter or y approves the displayed changes and verification requests. Pasting never approves.

What happens at sign-in?

Sign-in lets this terminal read your account, models and usage, and manage agent keys. It names this machine's previous terminal key before approval, then revokes it after saving the new key. A pasted shared key is replaced, never revoked. With plans on sale, full-screen sign-in asks workspace owners without a plan once: pay as you go or coding plan.

How do I undo a connection?

Use runinfra disconnect . After approval, it removes the launcher and profile, or restores in-place settings. Local changes that block removal or restoration show recovery steps.

Can I use the CLI in scripts?

Account and connection commands: --json returns one document; redirected output uses NDJSON. Help and version stay plain text without --json. Commands needing approval exit 8 without --yes. Review changes and costs first.

How do I manage a plan?

Run runinfra plan for usage and reset times. Use runinfra plan buy for checkout, or runinfra plan settings to manage it. Changes happen in your browser; the CLI waits for confirmation.

Connect your coding agents

Connect coding agents to RunInfra. Review changes, choose models, manage keys and check your account from the terminal.

$ npm install -g @runinfra/cli

Requires npm with a 22+ runtime.

Connecting Claude Code creates claude-run. claude keeps your own setup.
Pick another name with --name work-agent, or press e in Review. Follow the PATH hint if needed.
Some agents connect in place. Review says so.

Ready agents: Claude Code, Codex, OpenCode, Pi, Aider, Qwen Code, Kilo Code, Goose, Continue, Cline, Droid (Factory), Grok Build, Hermes, OpenClaw, Crush, Kimi CLI, Mistral Vibe, Forge, Nanocoder.

mona@your-terminal

mona@your-terminal:~$ runinfraOpens the full-screen app.Sign in with your browser or a device code.Pick agents, review, connect.Enter takes the next step.mona@your-terminal:~$

mona@your-terminal

╭─────────────────────────────────────────────────────────────────────────────╮
│                                                                             │
│               ████                                                          │
│               ██  ██   RunInfra                                             │
│               ████     Optimized models for your coding agents              │
│               ██  ██                                                        │
│                                                                             │
│  Local connections not checked. Not signed in.                              │
│                                                                             │
│  ╭──────────────────────────────────────────────────────────────────────╮   │
│  │ › Connect your coding agents                                         │   │
│  │   Arrows choose. Enter opens.                                        │   │
│  ╰──────────────────────────────────────────────────────────────────────╯   │
│                                                                             │
│    Status                                                                   │
│    live usage, cache, errors and spend                                      │
│    Keys                                                                     │
│    Account                                                                  │
│    Doctor                                                                   │
│    Help                                                                     │
│                                                                             │
│ enter start  ? help  q quit  tab choose  l sign in  r refresh         v0.3.1│
╰─────────────────────────────────────────────────────────────────────────────╯

One place for your connections

Use agent IDs from runinfra agents, or a connected launcher name. runinfra help lists options.

runinfra login [--device|--paste]: Sign this terminal in.
runinfra logout [--local]: Sign this terminal out.
runinfra whoami: Show stored identity.
runinfra status: Watch live usage in a terminal.
runinfra agents: Find supported agents without changing files.
runinfra connect <agent>...: Review, connect and verify.
runinfra disconnect <agent>...: Remove profiles or restore in-place settings.
runinfra models: List available models.
runinfra models set <agent> <model-id>: Change an agent's model.
runinfra models sync: Refresh connected agents' models.
runinfra keys: List agent key prefixes.
runinfra keys rotate <agent>: Replace an agent key safely.
runinfra keys revoke <agent>: Disconnect and revoke the agent key.
runinfra keys revoke --id <keyId>: Revoke a workspace agent key.
runinfra keys cap <agent> <dollars|none>: Set or remove a spend cap.
runinfra account: Show your account.
runinfra plan: Show plan use, limits and reset times.
runinfra plan buy <starter|pro|team>: Open browser checkout, then wait for confirmation.
runinfra plan settings: Open browser settings, then wait for confirmation.
runinfra doctor: Diagnose connections. Paid checks require --verify.
runinfra update [--check]: Check for or install a newer CLI release.
runinfra tui: Open the full-screen app.
runinfra help [--json]: Show commands and options.
runinfra version [--json]: Show the CLI version.

Common questions

Can't find what you're looking for? Get in touch

What pays for requests?

Review shows verification requests and what pays for them: your coding plan or credits. Credits-only keys always use credits. Doctor and model sync send no paid requests without --verify.

Connect coding agents to RunInfra. Review changes, choose models, manage keys and check your account from the terminal.

Connect your coding agents

Connect coding agents to RunInfra. Review changes, choose models, manage keys and check your account from the terminal.

$ npm install -g @runinfra/cli

Requires npm with a 22+ runtime.

Ready agents: Claude Code, Codex, OpenCode, Pi, Aider, Qwen Code, Kilo Code, Goose, Continue, Cline, Droid (Factory), Grok Build, Hermes, OpenClaw, Crush, Kimi CLI, Mistral Vibe, Forge, Nanocoder.

mona@your-terminal

mona@your-terminal:~$ runinfraOpens the full-screen app.Sign in with your browser or a device code.Pick agents, review, connect.Enter takes the next step.mona@your-terminal:~$

mona@your-terminal

╭─────────────────────────────────────────────────────────────────────────────╮
│                                                                             │
│               ████                                                          │
│               ██  ██   RunInfra                                             │
│               ████     Optimized models for your coding agents              │
│               ██  ██                                                        │
│                                                                             │
│  Local connections not checked. Not signed in.                              │
│                                                                             │
│  ╭──────────────────────────────────────────────────────────────────────╮   │
│  │ › Connect your coding agents                                         │   │
│  │   Arrows choose. Enter opens.                                        │   │
│  ╰──────────────────────────────────────────────────────────────────────╯   │
│                                                                             │
│    Status                                                                   │
│    live usage, cache, errors and spend                                      │
│    Keys                                                                     │
│    Account                                                                  │
│    Doctor                                                                   │
│    Help                                                                     │
│                                                                             │
│ enter start  ? help  q quit  tab choose  l sign in  r refresh         v0.3.1│
╰─────────────────────────────────────────────────────────────────────────────╯

One place for your connections

Use agent IDs from runinfra agents, or a connected launcher name. runinfra help lists options.

runinfra login [--device|--paste]: Sign this terminal in.
runinfra logout [--local]: Sign this terminal out.
runinfra whoami: Show stored identity.
runinfra status: Watch live usage in a terminal.
runinfra agents: Find supported agents without changing files.
runinfra connect <agent>...: Review, connect and verify.
runinfra disconnect <agent>...: Remove profiles or restore in-place settings.
runinfra models: List available models.
runinfra models set <agent> <model-id>: Change an agent's model.
runinfra models sync: Refresh connected agents' models.
runinfra keys: List agent key prefixes.
runinfra keys rotate <agent>: Replace an agent key safely.
runinfra keys revoke <agent>: Disconnect and revoke the agent key.
runinfra keys revoke --id <keyId>: Revoke a workspace agent key.
runinfra keys cap <agent> <dollars|none>: Set or remove a spend cap.
runinfra account: Show your account.
runinfra plan: Show plan use, limits and reset times.
runinfra plan buy <starter|pro|team>: Open browser checkout, then wait for confirmation.
runinfra plan settings: Open browser settings, then wait for confirmation.
runinfra doctor: Diagnose connections. Paid checks require --verify.
runinfra update [--check]: Check for or install a newer CLI release.
runinfra tui: Open the full-screen app.
runinfra help [--json]: Show commands and options.
runinfra version [--json]: Show the CLI version.

Common questions

Can't find what you're looking for? Get in touch

What pays for requests?

Review shows verification requests and what pays for them: your coding plan or credits. Credits-only keys always use credits. Doctor and model sync send no paid requests without --verify.