Skip to content
Fast Inference
DOCS / CLI
Platform

CLI

Install the fast command, sign in, and connect coding agents to Inference.net from the terminal.

The Inference Fast CLI (fast) connects supported coding agents to your first Fast Inference project. It signs in through the dashboard, creates one machine-scoped API key when you connect an agent, and can restore every config file it changes.

Install and sign in

  1. Install the CLI

    Choose the package manager you already use.

    bash
    npm install -g @inference/fast
# or: pnpm add -g @inference/fast
# or: bun add -g @inference/fast
# or: yarn global add @inference/fast

  2. Sign in

    bash
    fast login

    The command opens a browser approval flow. After approval, it selects the first project in your personal workspace—the same project used throughout fast-web.

  3. Confirm the connection

    bash
    fast status

    Status shows your account, selected project, machine key, endpoints, and the connection state of every supported coding agent.

Common commands

CommandPurpose
fast loginSign in through the Fast Inference dashboard.
fast statusShow the account, project, machine key, and agent states.
fast claude onConnect Claude Code.
fast codex onConnect Codex.
fast opencode onConnect OpenCode.
fast pi onConnect Pi.
fast <agent> statusShow an agent's connection, model, and config paths.
fast <agent> offRestore that agent's original configuration.
fast logoutRestore all connected agents, disable the machine key, and sign out.
fast --helpShow the complete command tree.

Calling an agent without on is equivalent to turning it on, so fast claude and fast claude on do the same thing.

Connect a coding agent

Four adapters are currently available:

bash
fast claude on
fast codex on
fast opencode on
fast pi on

The first connection creates one project-scoped key named for your machine. The CLI reuses that key for the other supported agents. To choose a model, provide its catalog ID with --model:

bash
fast codex on --model glm-5.2

Each adapter snapshots the original files before changing them. Choose an integration guide for the exact paths and verification flow:

Files and local configuration

CLI state, transport credentials, and reversible backups live under ~/.inference-fast. Files that can contain credentials are written with owner-only permissions.

For local development, these environment variables override the defaults:

VariablePurpose
INFERENCE_FAST_CONFIG_DIRMove CLI state and backups to another directory.
INFERENCE_FAST_RELAY_URLOverride the authorization and tRPC relay.
INFERENCE_FAST_DASHBOARD_URLOverride the browser approval dashboard.
INFERENCE_FAST_API_URLOverride the inference gateway.
INFERENCE_FAST_MODELChange the default model used by new connections.

Disconnect safely

Restore one agent without signing out:

bash
fast claude off
fast claude status

Or restore every connected agent, disable the machine-scoped key, and close the session in one step:

bash
fast logout