b3iq CLI

Manage your b3iq machines from the terminal — list them, see what models they serve, and open an SSH session without touching a ProxyCommand.

npm i -g @b3dotfun/b3iq-cli        # Node ≥ 20

b3iq login                       # sign in via your browser (device flow)
b3iq status
b3iq machines list
b3iq ssh my-box

Requires Node 20+. Ships compiled, with zero runtime dependencies.

Commands

| command | what | |---|---| | login | sign in via your browser (--token <t> for CI, or set B3IQ_TOKEN) | | logout [--revoke] | forget the saved token (--revoke also kills it server-side) | | whoami | show the logged-in account | | status | fleet overview — machines online + servable models | | machines list | list your machines (--quiet ⇒ node ids) | | machines get <machine> | one machine's detail | | models list [--machine <id>] | servable models across the fleet, or one machine's full catalog | | models install <model> --machine <id> | install a model on a machine (--no-wait to not block until done) | | models remove <model> --machine <id> | uninstall a model from a machine (--no-wait to not block until done) | | runtimes list [--machine <id>] | a machine's runtimes, with status and self-heal coverage | | runtimes restart <runtime> --machine <id> | restart a runtime (--no-wait to not block until done) | | logs [--limit <n>] [--follow] | recent gateway request logs; --follow streams new events (NDJSON in --json mode) | | ssh <machine> [-- cmd] | open an SSH session (transport handled for you) | | config [default-machine <id>] | view / set config | | doctor | diagnose auth, API reachability, cloudflared |

<machine> accepts a node-id, id prefix, or a substring of the machine name.

Output

stdout is data, stderr is logs. JSON is automatic when piped; --json forces it, --quiet prints only ids. Exit codes: 0 ok · 1 usage · 2 api · 3 auth · 4 rate-limited. See AGENTS.md for headless/agent recipes.

Config

~/.b3iq/config.json (mode 0600). Env overrides the file: B3IQ_TOKEN, B3IQ_API_URL, B3IQ_ORG_ID.

Zero runtime dependencies — the CLI is stdlib-only and ships as source that Node type-strips on the fly.