@cortexlabs/forge

Forge CLI

Forge is a local engineering terminal backed by the Forge platform.

Install

Forge requires Node.js 20 or newer. Install the current prerelease globally:

npm install -g @cortexlabs/forge@next

Verify the installation:

forge --help
forge doctor

You can also run Forge without installing it globally:

npx @cortexlabs/forge@next --help

Start

forge login
forge status
forge

forge login opens the Forge website in your browser. Sign in and approve the terminal connection; you do not need to copy an API key. For headless environments, FORGE_API_KEY and forge login --api-key remain available.

forge opens the interactive terminal. Use /help inside it. Use --json with a command for machine-readable newline-delimited events.

Forge never enables paid over-limit usage, changes spending limits, publishes, deploys, or performs destructive work without an explicit approval flow.