Setup the predictr-cli

Drive predictr.io from your shell. The CLI is distributed as a uv tool — install it once and it's available in every shell.

1. Install the CLI

uv tool install git+https://github.com/predictr-io/predictr-cli

2. Point it at the API

Set the API base URL and your organisation slug. The org slug is the one you picked at sign-up — visible at the top of the web UI.

Linux / macOS

export PREDICTR_API_URL="https://api.predictr.io"
export PREDICTR_ORG="<your-org>"

Windows (PowerShell)

$env:PREDICTR_API_URL = "https://api.predictr.io"
$env:PREDICTR_ORG = "<your-org>"

3. Authenticate

The CLI accepts either of two credential modes.

Bearer token (short-lived)

A bearer token tied to your current web session. Easiest for ad-hoc work, but expires when the session does (see the Setup CLI card on the Welcome screen in the web UI for a one-click copy of the current token).

export PREDICTR_BEARER_TOKEN='<paste-from-web-ui>'

API key (long-lived)

For scheduled jobs, CI, or anything you don't want to re-paste every session.

export PREDICTR_API_KEY="<your-api-key>"

Generate or rotate keys from the Account page in the web UI.

Sanity check

predictr-cli orgs list

If the CLI returns your organisation, you're connected.