VectorCI guide

Authenticate with GitHub

Use GitHub CLI web authentication and explicit GitHub App consent without copying tokens into VectorCI.

Sign in

GitHub is the identity provider. VectorCI asks GitHub CLI to start its browser-based login flow, then reads only the authenticated account identity and repository metadata it needs for setup.

Authenticate and check status

npx vectorci auth login
npx vectorci auth status

Install the VectorCI GitHub App

Setup can open the App installation page after a reviewed plan is applied. Select only the private repositories that should use VectorCI.

Open App consent after apply

npx vectorci setup . --apply --plan-digest <reviewed-sha256> --confirm WRITE_VECTORCI_CONFIG --open-app

Automation behavior

Exit 0: authenticated and usable.
Exit 3: action is required, such as signing in or completing setup.
Exit 1: invalid input or a security boundary rejected the request.
Exit 2: command usage is invalid.