Premia
CLI

Command cheat sheet

Every premia command on one page. For per-command detail, see the domain pages.

A one-page index of every command. For arguments, examples, and sample output, see the deep references: Runs · Agents · Pipelines · Secrets & repos.

Auth

premia login [--token premia_xxx] [--api-url URL] [--no-browser]
premia logout
premia whoami [--json]
premia init --project <public-id>

Runs

premia run "<description>" [--project P] [--title T] [--wait] [--json]
premia runs list [--status <s>] [--limit N] [--json]
premia runs view <id> [--json]
premia runs logs <id> [--follow] [--level info|warning|error] [--json]
premia runs cancel <id>
  • run --wait blocks until the run and its children finish; exit code reflects success.
  • runs logs --follow streams new logs until the run reaches a terminal state.

Agents (the code dev loop)

premia agents list [--json]
premia agents view <slug> [--json]
premia agents pull <slug> [--force]        # → ./<slug>.py
premia agents push <slug> [--file PATH]     # upload local changes
premia agents deploy <slug> [--wait]        # build + deploy to our cloud

See Custom code agents for the run(context) contract.

Pipelines (as code)

premia pipelines list [--json]
premia pipelines pull <id> [--out FILE] [--force]
premia pipelines push <file> [--id <id>] [--project <p>]

See Pipeline as code for the JSON spec.

Secrets & repos

premia secrets list [--json]
premia secrets set <KEY> <value>            # or: echo -n $V | premia secrets set <KEY>
premia secrets delete <KEY>
premia repos list [--json]

On this page