Upstream CLI

The upstream CLI brings repository and Change Request workflows to your terminal. It also installs a Git credential helper, so HTTPS clone, fetch, and push use your Upstream identity without pasted tokens.

Install

curl -fsSL https://downloads.coline.dev/upstream/install.sh | sh

The installer selects the published release for macOS or glibc-based Linux on x64 or Arm64, verifies its SHA-256 checksum, and places upstream under ~/.local/bin by default.

Windows and musl-based Linux distributions are not currently supported.

Sign in

upstream auth login

The CLI prints a one-time browser URL and waits for you to approve the request using your existing Coline identity. After approval, it stores a revocable CLI session and configures the Git credential helper automatically.

Confirm the session:

upstream auth status

Clone a repository

upstream repo clone {namespace}/{repository}

For HTTPS operations, the helper mints a short-lived repository credential and limits its scope to your actual repository role. To use an account SSH key instead, add --ssh.

Keep it current

upstream update

The CLI supports stable and latest release channels. Read the CLI command reference for the complete command surface.