tilldev — the TillDev CLI

Terminal parity with the dashboard: do most day-to-day work — across TillPulse (observability) and TillAuth (auth) — without leaving the shell. Anything the CLI does, the dashboard does too, and vice-versa.

npm i -g @tillstack/cli     # or: pnpm --filter @tillstack/cli build && npm link
tilldev login
tilldev pulse projects

Auth

The CLI stores its token at ~/.tilldev/config.json (mode 0600). A plain login saves a ~1h access token (it re-prompts on expiry). For CI, mint a long-lived API key and export it:

tilldev keys create ci --scopes read,write
export TILLDEV_TOKEN=tp_…        # picked up automatically

Commands

Account
  login | logout | whoami
  config get [key] | config set <api-url|org|project> <value>

TillPulse (tilldev pulse …)
  projects | projects create <name> --platform <ios|android|react-native|flutter|web>
  project <id> | dsn rotate <id>
  issues [--project <id>] [--limit <n>] | issue <id>
  metrics [--project <id>] | alerts
  releases create <projectId> <version> [--build --env --commit]
  sourcemaps|proguard|dsym upload <projectId> --release <v> --file <path>
  ask "<question>"                 # natural-language query over your telemetry

TillAuth (tilldev auth …)
  apps | apps create <name> | app <appId>

Workspace
  team | keys | keys create <name> [--scopes read,write,admin]

Global flags

| Flag | Env | Meaning | |---|---|---| | --api-url <url> | TILLDEV_API_URL | API base (default https://tilldev.dev) | | --token <t> | TILLDEV_TOKEN | Auth token / API key | | --json | | Raw JSON instead of tables (scriptable) | | --help, -h | | Usage |

Colors auto-disable when piped or when NO_COLOR / TILLDEV_NO_COLOR is set, so tilldev pulse issues --json | jq … stays clean.