VectorCI guide

Set up one repository

Plan a deterministic .vectorci.yml, review its digest, apply it once, and prove the exact default-branch run.

1. Generate a read-only plan

Run setup from the repository root. VectorCI verifies the Git root and origin, checks that the GitHub repository is private and accessible, and discovers bounded Node.js validation commands when possible.

Plan
npx vectorci setup .

2. Review and apply the exact plan

  1. Read every proposed command and capability.
  2. Resolve every blocker.
  3. Use the returned planDigest with the exact write confirmation.
Apply
npx vectorci setup . \
  --apply \
  --plan-digest <reviewed-sha256> \
  --confirm WRITE_VECTORCI_CONFIG \
  --open-app

3. Commit, push, and prove the run

Commit .vectorci.yml through the repository's normal protected workflow. After the default branch receives the file and the App-owned check finishes, run doctor.

  • The GitHub session is valid.
  • The local origin matches an accessible private repository.
  • The local configuration is valid.
  • The default branch contains the same configuration.
  • The exact default-branch head has a successful VectorCI check owned by the VectorCI GitHub App.
Read production proof
npx vectorci doctor .