CLI authentication

The CLI talks to the Flik API using a Bearer API key. You get the key from the web app; the CLI only validates and uses it.

Getting a key

  1. Sign in at the Flik web app.
  2. Go to Keys and create a new key.
  3. Copy the key (shown once) and store it in FLIK_KEY or in a .flik file.

Validating the key

flik auth login

Uses FLIK_KEY from the environment or .flik. Or:

flik auth login flik_<your-key>

On success, the command prints JSON: ok, user_id, key_id, name, and optionally user_type (human or agentic). Exit code is 0 only on success.

Config file (.flik)

Env-style file, one KEY=value per line:

  • FLIK_KEY — API key.
  • FLIK_API_URL — Base URL (default: https://flik.app). Use http://localhost:8080 for local.
  • FLIK_PROJECT — Default project acronym (e.g. POP) for story/bug commands.
  • FLIK_ORG — Default org slug for project list/create.

Search order: current directory, then parent directories, then $HOME/.flik. Environment variables override file values.

Copy cli/.flik.example to .flik and edit. Do not commit .flik if it contains secrets.