Install and sign in

The CLI signs you in, connects coding agents and hands off a local Git checkout to a new thread. The conversation and review stay in the browser; the CLI never holds a transcript.

Install

There is no published package yet. The pre-launch CLI runs from the Statefold source repository with Bun:

bun install --frozen-lockfile
bun run statefold --help

From the source checkout, use bun run statefold wherever these docs say statefold. Running it with no arguments in a terminal opens an interactive home.

Choose a target

The CLI talks to one target at a time, chosen per repository: Local (http://localhost:3000) or Staging (https://staging.statefold.sh). Each target has its own sign-in and connections.

statefold use staging
statefold config

Check the active target with statefold config before sending work.

Sign in

statefold login

The CLI prints a device code and a verification address. Approve the device in the browser where you are signed in. statefold account shows sign-in status for each target; statefold logout removes the sign-in for the active target, and --all removes every target's after confirming.

Check your setup

statefold doctor

doctor inspects the repository, target and credential state. Add --json for machine-readable output.

Next: Commands.