Fallbakit CLI
Configuration
Where the Fallbakit CLI stores config and credentials, the precedence of settings, and the environment variables for headless and self-hosted use.
Files
The CLI keeps everything under ~/.fallbakit/:
| Path | Contents | Permissions |
|---|---|---|
~/.fallbakit/config.json | Non-secret settings (dashboardUrl, apiBaseUrl). | 0644 |
~/.fallbakit/auth.json | Signed-in cli_* token and identity. | 0600 |
~/.fallbakit/runners/<id>.json | Per-runner credentials from runner create. | 0600 |
Print the config directory with:
fallbakit config pathSettings
Two settings control which backend the CLI talks to:
| Key | Default | Description |
|---|---|---|
dashboardUrl | https://fallbakit.com | Dashboard management API the CLI authenticates and operates against. |
apiBaseUrl | https://api.fallbakit.com | OpenAI-compatible gateway base URL written into scaffolded apps. |
View and change them:
fallbakit config get
fallbakit config set dashboardUrl https://fallbakit.example.com
fallbakit config set apiBaseUrl https://api.fallbakit.example.comEnvironment variables
Environment variables take precedence over config.json, which takes precedence over the built-in defaults. Use them for CI, headless hosts, or self-hosted deployments.
| Variable | Overrides | Description |
|---|---|---|
FALLBAKIT_TOKEN | auth.json token | Use this cli_* token instead of the stored credentials. |
FALLBAKIT_DASHBOARD_URL | dashboardUrl | Dashboard management API URL. |
FALLBAKIT_API_BASE_URL | apiBaseUrl | OpenAI-compatible gateway base URL. |
FALLBAKIT_CONFIG_HOME | ~/.fallbakit | Directory for config, credentials, and runner files. |
Precedence, highest first:
environment variable > config.json > built-in defaultNon-interactive auth
In CI or other non-interactive environments, set FALLBAKIT_TOKEN to a CLI token and skip login entirely:
export FALLBAKIT_TOKEN=cli_xxxxxxxx
fallbakit whoami
fallbakit usage --range 24h --jsonSelf-hosted backend
Point the CLI at your own deployment by setting both URLs:
export FALLBAKIT_DASHBOARD_URL=https://fallbakit.example.com
export FALLBAKIT_API_BASE_URL=https://api.fallbakit.example.com
fallbakit login