CLI command reference

Run upstream --help at any time to see the command surface installed on your machine.

Authentication

upstream auth login
upstream auth status
upstream auth setup-git
upstream auth logout

setup-git installs or repairs the HTTPS credential helper. A successful login runs it automatically.

Workspaces and repositories

upstream workspace list
upstream workspace use {namespace}
upstream repo list [--json]
upstream repo create {slug} --workspace {namespace}
upstream repo view [{namespace}/{repository}] [--json]
upstream repo clone {namespace}/{repository} [directory] [--ssh]
upstream repo delete {namespace}/{repository}

Inside a clone, repository-aware commands infer the target from the origin remote when possible.

Change Requests

upstream cr list [-R {namespace}/{repository}]
upstream cr create -t "Title" [-H head] [-B base] [--push]
upstream cr view {number}
upstream cr diff {number} [--version N]
upstream cr comment {number} --body "Comment"
upstream cr review {number} --approve
upstream cr checks {number}
upstream cr checkout {number}
upstream cr update {number}
upstream cr ready|close|reopen {number}
upstream cr merge {number} [--squash|--rebase]
upstream cr rebase {number}
upstream cr stack -R {namespace}/{repository}

Reviews and checks remain pinned to the Change Request version they evaluated.

Rules and raw API reads

upstream ruleset list {namespace}/{repository}
upstream ruleset view {namespace}/{repository}
upstream api /api/v1/upstream/...

upstream api currently performs an authenticated GET with your CLI session. It is useful for inspection, not a generic mutation command.

Updates

upstream config get-channel
upstream config set-channel stable|latest
upstream update