Commands

Full reference for every Fallbakit CLI command — authentication, runners, applications, insights, and configuration — with flags and examples.

Run fallbakit <command> --help for command-specific flags at any time. IDs shown below (runner, application, key) come from the matching list command or the dashboard.

Authentication

fallbakit login

Flag	Default	Description
`--token <cli_token>`	—	Authenticate with a CLI token instead of the browser flow.
`--dashboard-url <url>`	`https://fallbakit.com`	Dashboard to authenticate against (persisted to config).
`--no-browser`	`false`	Do not open a browser automatically.

`logout`

Remove stored credentials from ~/.fallbakit/auth.json.

fallbakit logout

`whoami`

Show the signed-in user, account, plan, and runner limit.

fallbakit whoami

Runners

Manage local runners. A runner is a registered connection between Fallbakit and one local runtime (Ollama, oMLX, or vLLM).

`runner create`

Create a runner and, optionally, launch the tunnel agent for it.

fallbakit runner create --name my-mac --runtime ollama --launch

Flag	Default	Description
`--name <name>`	—	Runner name.
`--runtime <runtime>`	—	Runtime: `ollama`, `omlx`, or `vllm`.
`--target <target>`	`binary`	Deployment target: `binary` or `docker`.
`--local-url <url>`	—	Local runtime base URL (e.g. `http://localhost:11434`).
`--launch`	`false`	Launch the agent after creating the runner.

Credentials are written to ~/.fallbakit/runners/<runner-id>.json. The command prints the runner environment and the fallbakit runner up line to start it.

`runner list`

List your runners (alias: ls).

fallbakit runner list

`runner status`

Show all runner statuses, or diagnose one by ID.

fallbakit runner status
fallbakit runner status <runner-id>

Flag	Default	Description
`--watch`	`false`	Re-run diagnostics every few seconds.

`runner up`

Launch the tunnel agent for an already-configured runner (alias: start).

fallbakit runner up <runner-id>

`runner rotate`

Rotate a runner's API key. The agent must be restarted to pick up the new key.

fallbakit runner rotate <runner-id>

`runner rm`

Delete a runner (alias: delete).

fallbakit runner rm <runner-id>

Applications

Manage applications, their traffic, and their API keys.

`app init`

Set up an application and API key for the current project, scaffolding .env-style files when a package.json or pyproject.toml is detected.

fallbakit app init --name my-web-app

Flag	Default	Description
`--name <name>`	—	Application name.
`--no-files`	`false`	Create the application and key but do not write project files.

The API key is shown once — store it in your secret manager. Requests use the base URL https://api.fallbakit.com.

`app list`

List applications (alias: ls).

fallbakit app list

`app enable` / `app disable`

Activate or deactivate an application by ID.

fallbakit app enable <application-id>
fallbakit app disable <application-id>

`app key`

Create or revoke API keys for an application.

# Create (key shown once)
fallbakit app key create --app <application-id> --name "ci key"

# Revoke
fallbakit app key rm <key-id> --app <application-id>

Flag	Default	Description
`--app <id>`	`default`	Application id.
`--name <name>`	`cli key`	Key name (create only).

Insights

`requests`

Show recent requests as a table, or raw JSON.

fallbakit requests --app <application-id> --range 7d --limit 50

Flag	Default	Description
`--app <id>`	`default`	Application id.
`--limit <n>`	`20`	Maximum number of requests to show.
`--range <range>`	`24h`	Time range: `24h`, `7d`, or `30d`.
`--json`	`false`	Print raw JSON instead of a table.
`--watch`	`false`	Refresh every few seconds.

`usage`

Show usage totals for an application over a time range.

fallbakit usage --app <application-id> --range 30d

Flag	Default	Description
`--app <id>`	`default`	Application id.
`--range <range>`	`24h`	Time range: `24h`, `7d`, or `30d`.
`--json`	`false`	Print raw JSON instead of a table.

Other

`config`

View or change CLI settings. See Configuration for details.

fallbakit config get
fallbakit config set dashboardUrl https://fallbakit.com
fallbakit config path

`version`

Print the CLI version (aliases: --version, -v).

fallbakit version

On this page