Skip to main content
The Outkit CLI is the fastest and recommended way to set up Outkit. One command detects your framework, installs the right SDK, picks a profile, generates an API key, and writes the proxy endpoint your app needs — no dashboard tab-switching, no manual config.
npm install -g @outkit-dev/cli@latest
outkit login
outkit init

Install

npm install -g @outkit-dev/cli@latest
Verify the install:
outkit --help

Sign in

outkit login
outkit login runs a device-code flow: it opens your browser to the dashboard, you approve the device, and a token is saved to ~/.outkit/credentials.json (mode 0600). Confirm your setup:
outkit whoami
# user, team, and active device
outkit doctor
# end-to-end health check: auth, network, project mode, SDK, wire format

What the CLI Does

Project setup

outkit init detects your framework, picks a profile, installs the SDK, and writes the backend proxy.

API keys

outkit keys create / rotate / revoke / stats — manage every key without leaving the terminal.

Theme sync

outkit theme detect / apply / sync — pull design tokens from your codebase straight into your Outkit profile.

Local development

outkit dev, outkit logs tail, outkit doctor — run alongside your dev server.

Full reference

Every command, flag, env var, and config file the CLI reads or writes.

Files the CLI Manages

PathPurposeCommit?
outkit.jsonRepo-local config: version, mode, teamId, profileId, backendUrl?, themeMap?yes
outkit.theme.jsonLocal copy of the active profile’s design tokensyes
~/.outkit/credentials.jsonAuth token (mode 0600)never
~/.outkit/undo.jsonAppend-only journal feeding outkit undonever
~/.outkit/telemetry.logLocal NDJSON log of analytics eventsnever

Environment Overrides

VariableDefaultWhen to set
OUTKIT_API_BASE_URLhttps://api.outkit.devStaging or self-hosted backends
OUTKIT_DASHBOARD_BASE_URLhttps://app.outkit.devMatch an API override
OUTKIT_DEBUGunsetSet to 1 to print stack traces on errors

Next Steps

Quickstart

Five minutes from outkit init to your first enhanced response.

Project setup

What outkit init writes, framework support, and the outkit.json schema.