Skip to content
Scope

Install the CLI

The scope CLI lets you submit requests, list runs, stream logs, and manage profiles — all from your terminal.

Prerequisites

Section titled “Prerequisites”
  • Node.js ≥ 20 — nodejs.org
  • GitHub CLI (gh) — authenticated with access to the growth-ecosystems/scope-doc repo.
    Alternatively, set a GH_TOKEN or GITHUB_TOKEN environment variable with repo scope.

One-liner install

Section titled “One-liner install”
Terminal window
gh api repos/growth-ecosystems/scope-doc/contents/install-cli.sh \
  -H "Accept: application/vnd.github.raw" | bash

This downloads and installs the latest release to ~/.local/bin/scope. Override the location with the SCOPE_INSTALL_DIR environment variable:

Terminal window
SCOPE_INSTALL_DIR=~/bin \
  gh api repos/growth-ecosystems/scope-doc/contents/install-cli.sh \
  -H "Accept: application/vnd.github.raw" | bash

Add to PATH

Section titled “Add to PATH”

If ~/.local/bin is not already on your PATH, add it to your shell profile:

Terminal window
# ~/.bashrc, ~/.zshrc, or ~/.profile
export PATH="$HOME/.local/bin:$PATH"

Then reload your shell or run source ~/.bashrc (or equivalent).

Verify the installation

Section titled “Verify the installation”
Terminal window
scope --version

You should see the installed version number printed to stdout.

Updating

Section titled “Updating”
Terminal window
scope update

This downloads and installs the latest cli/v* release, replacing the current binary in place.

What’s next

Section titled “What’s next”