CLI

What the CLI does

fallbakit is the developer CLI for the platform. It is a thin, dependency-free front-end over the dashboard's management API: it signs you in, registers and launches local runners, scaffolds applications, mints API keys, and shows recent requests and usage — all without leaving the terminal.

The CLI talks to the dashboard at https://fallbakit.com using a cli_* token. It never touches the Go gateway directly, and the local tunnel agent ships separately (see Tunnel).

Install

# curl | sh (Linux + macOS)
curl -fsSL https://fallbakit.com/install.sh | sh

# Homebrew (macOS)
brew install --cask fallbakit/homebrew-tap/fallbakit

# Go toolchain
go install github.com/fallbakit/cli/cmd/fallbakit-cli@latest

Confirm the install:

fallbakit version

Sign in

Run login to start the OAuth-style device flow. The CLI opens your browser to the dashboard, where you confirm a short code; once approved, it stores a cli_* token locally.

fallbakit login

To finish signing in, open:
  https://fallbakit.com/dashboard/cli?code=WDJB-MJHT
and confirm this code: WDJB-MJHT

Waiting for approval…
✓ Logged in as user_2abc…

On a headless machine, skip the browser and either paste the URL elsewhere or authenticate with a token directly:

fallbakit login --no-browser
fallbakit login --token cli_xxxxxxxx

Check who you are and sign out:

fallbakit whoami
fallbakit logout

Quickstart

From a logged-in shell, go from zero to first request:

# 1. Register a local runner and launch the tunnel agent.
fallbakit runner create --name my-mac --runtime ollama --launch

# 2. In a new shell, scaffold an app + API key in your project.
fallbakit app init --name my-web-app

# 3. After sending traffic, inspect it.
fallbakit requests --range 24h
fallbakit usage --range 7d

Next steps

• Commands: the full command and flag reference.
• Configuration: config file, credential storage, and environment variables.
• Getting Started: the end-to-end platform walkthrough.