Skip to content

Commands (v1)

Platform control commands — first implementation priority for the public CLI.

CommandPhaseSynopsis
configv1Profiles, URL, init
authv1Login, whoami, refresh
appv1List/create apps, agent status
policyv1Recording, mock, compare YAML policies
replayv1Run, status, stop, rerun
healthv1Cluster health

Global flags on all API commands:

text
--json          Machine-readable stdout (required for agents)
--profile       Config profile name
--api-url       Override backend URL
--token         Override JWT (else SP_TOKEN / config)
--quiet         Suppress non-error stderr
--out-dir       Directory for artifact files

Cheat sheet

bash
sp config init && sp auth login --email u@c.com --code 123456 --json
sp app list --json
sp policy recording validate -f rec.yaml --json
sp policy recording apply -f rec.yaml --json
sp replay run --app my-app --env staging --from -24h --json
sp replay status <planId> --watch --json
sp health --json

Investigation commands are v2: Commands (v2).