steering

Authentication

How to authenticate against private repos and raise the rate limit.

Public repos need no token — the CLI tries unauthenticated first and only asks for a token on a 401/403 or when GitHub rate-limits anonymous requests.

For private repos or a higher rate limit, the CLI resolves the token in this order:

  1. GITHUB_TOKEN
  2. GH_TOKEN
  3. gh auth token (GitHub CLI)

gh is not required — setting GITHUB_TOKEN is enough. With none of these, on a private repo the CLI exits with clear guidance on how to authenticate.

export GITHUB_TOKEN=ghp_xxx
npx steering.sh add my-org/private-steering

Telemetry

Telemetry is disabled in this build. It respects DISABLE_TELEMETRY and DO_NOT_TRACK.

On this page