CLI reference

Global flags on every command: --context, --org, -p/--project, --json, -q/--quiet, --no-color.

Run slipway <command> --help for the authoritative text for your version.

Authentication and context

Command	Description
`slipway login`	Sign in and save a context. `--server`, `--token`, `--with-token`, `--no-browser`, `--name`
`slipway logout`	Remove the token. `--delete-context` removes the whole context
`slipway whoami`	Show the current user and org. `-v` lists effective permissions
`slipway org list` / `switch <slug>`	List and switch organisations
`slipway context list` / `use <name>` / `delete <name>`	Manage saved server contexts

Projects and pipelines

Command	Description
`slipway project list`	List projects
`slipway project create <slug>`	Create. `--name`, `--description`
`slipway project use <slug>`	Select the default project
`slipway pipeline list`	List pipelines. `--limit` (default 100)
`slipway validate [file...]`	Validate pipeline files locally (no server needed). Defaults to every `.slipway/*.yaml`

Runs

Command	Description
`slipway run list`	`--pipeline`, `--status`, `--branch`, `--limit` (default 20)
`slipway run trigger <pipeline>`	`--branch`, `--tag`, `--sha`, `-i/--input key=value` (repeatable), `-w/--watch`
`slipway run get <run>`	Show a run with its jobs and steps
`slipway run watch <run>`	Follow live with a job/step tree. `--exit-status` (default true)
`slipway run cancel <run>`	Cancel a queued or running run
`slipway run rerun <run>`	Re-run with the same inputs. `--failed`, `-w/--watch`
`slipway logs <run>`	Print or follow logs. `--job`, `--step`, `-f/--follow`, `--tail N`, `--timestamps`

slipway run trigger build --branch main -w
slipway run trigger release -i version=1.4.0 -i dry_run=false
slipway logs run_01H... --job test --follow

Releases and deployments

Command	Description
`slipway release list`	`--service`, `--channel`, `--limit` (default 30)
`slipway release create <service> <version>`	`--channel`, `--notes` or `--notes-file`, `--run` (provenance), `--artifact name=version-or-digest` (repeatable)
`slipway release get <service> <version>`	Show a release and where it is deployed
`slipway deploy <service> <version>`	Deploy a release (`<version>` may be `latest`). `-e/--env` (required), `--strategy recreate\|rolling\|bluegreen\|canary\|progressive`, `--comment`, `--wait`
`slipway promote <service> [version]`	`--from`, `--to`, `--comment`, `--wait`
`slipway rollback <service>`	`-e/--env` (required), `--to <version>`, `--comment`, `--wait`
`slipway approve <deployment>` / `slipway reject <deployment>`	Decide an approval. `-m/--comment`
`slipway deployment list`	`--service`, `-e/--env`, `--status`, `--limit` (default 30)
`slipway deployment get <deployment>`	Show a deployment and its strategy steps
`slipway env list`	List environments. `--service`

slipway release create api 1.4.0 --run run_01H... --artifact image=ghcr.io/acme/api@sha256:abc
slipway deploy api 1.4.0 --env staging
slipway deploy api latest --env production --strategy canary --wait
slipway promote api --from staging --to production
slipway deployment list --status waiting_approval
slipway approve dep_01H... -m "Dashboards look healthy"
slipway rollback api --env production

Environment protection rules (approvals, windows, freezes, policies) always apply. If a deployment is waiting, the command says so and, with --wait, keeps waiting.

Secrets

Values are write-only.

Command	Description
`slipway secret set <NAME>`	Create or rotate. `--value` (visible in history; avoid), `--stdin`, `--from-file`, `--external-ref ref`. The value is prompted when none is given
`slipway secret list`	Names and metadata only
`slipway secret delete <NAME>`	Delete

Shared flags for secret: --scope org\|project\|environment (default project) and -e/--env (implies environment scope).

Runners

Command	Description
`slipway runner list`	`--pool`, `--status online\|offline\|busy\|draining`, `--limit`
`slipway runner token <pool>`	Create a registration token for a pool
`slipway runner pool list`	List pools
`slipway runner pool create <name>`	`--executor docker\|kubernetes\|shell` (default docker), `--scope org\|project`, `--label` (repeatable); warns when the pool has no labels
`slipway runner pool update <pool>`	`--name`, `--label` (replace the set), `--add-label`, `--remove-label`, `--concurrency` (0 = unlimited)
`slipway runner`	Run a runner (this is the agent, not the CLI). See Runners
`slipway runner check` / `version`	Validate configuration, executor and the path to the server (`--no-server` skips the probe), print version

Server components

The same binary runs the control plane: slipway server, scheduler, worker, all (development), migrate up. See Self-hosting.