CLI install and authentication

The DevFlow CLI is a thin wrapper over the rest-api-overview. It targets Node 18+ and macOS / Linux / Windows (PowerShell + WSL both fine).

install

npm install -g @devflow/cli

Verify:

devflow --version
# 5.0.2

Homebrew tap (brew install devflow-io/tap/devflow) and a single-binary release on GitHub Releases are also available — handy for CI runners.

authenticate

devflow login

This opens a browser for the OAuth handshake. The CLI stores a long-lived refresh token in ~/.devflow/credentials (mode 600, you can verify with stat).

For CI, prefer service-account API keys instead of devflow login:

export DEVFLOW_API_KEY=df_pat_xxxx
devflow whoami

Service accounts are scoped tokens that never expire silently — they're rotatable and can be IP-allow-listed. See rest-api-authentication for the full lifecycle.

configure defaults

devflow config set workspace acme-prod
devflow config set project payments-api

After this, commands no longer need the --workspace and --project flags every time.

what next

• Apply your first monitor — quickstart.
• Use the CLI from CI — see the example in terraform-provider for the same shape with the Terraform path.
• If your shell can't find devflow after install, your global npm prefix isn't on $PATH — npm config get prefix and add its bin directory to $PATH.