Security: see references/scanner-notes.md and upstream SECURITY.md for expected scanner signals and trust model.
Verasic GitHub CLI Init — Local Agent Harness Auth
Workflows
All paths below assume the Cursor install root; installed elsewhere (e.g. .agents/skills/), adjust the prefix — the scripts themselves are install-root-agnostic. /verasic-init runs the bootstrap for you.
Orchestration (Cursor)
Wire GitHub CLI auth for the local AI agent harness on this repo.
Read .cursor/skills/verasic-github-cli-init/references/setup-protocol.md (or .agents/skills/verasic-github-cli-init/references/setup-protocol.md for cursor-hybrid installs), then run from the repository root:
bash .cursor/skills/verasic-github-cli-init/scripts/bootstrap.sh
After bootstrap, tell the user clearly:
- Create a fine-grained PAT scoped to this repo (link: https://github.com/settings/tokens?type=beta) — recommended permissions are in the setup protocol.
- Copy
.github-agent.local.example→.github-agent.local, setGH_TOKEN, runchmod 600 .github-agent.local(never commit). - Run
direnv allowif they use direnv. - Verify with
bash .cursor/skills/verasic-github-cli-init/scripts/check-gh.sh.
Do not run gh auth login device-flow loops. Do not print or commit token values. Do not run bare gh auth status in chat — use check-gh.sh.
Bootstrap path — wire a repo once:
- Read
references/setup-protocol.md(in this skill's directory) for secrets tiers and PAT permissions. - From the repo root:
bash .cursor/skills/verasic-github-cli-init/scripts/bootstrap.sh(or/verasic-github-cli-initin Cursor, or let/verasic-initdo it). - User creates
.github-agent.localwithGH_TOKEN(never commit). - Verify:
bash .cursor/skills/verasic-github-cli-init/scripts/check-gh.sh
Runtime path — before any gh command:
- If
GH_TOKENis unset, load credentials without executing env files:
source .cursor/skills/verasic-github-cli-init/scripts/load-gh-env.sh
- Use
ghwith-R "${GH_REPO}"when auto-detection fails. - Never log or commit tokens. Do not run bare
gh auth statusin agent logs — usecheck-gh.sh.
Source of truth
The full spec lives in references/setup-protocol.md. The Cursor rule is a thin digest; never duplicate the spec elsewhere.
Hard rules
- Local agents →
.github-agent.local; CI → GitHub Actions; production → secrets manager — never mix tiers. - One fine-grained PAT per repo, scoped to that repo only.
- Never use
gh auth logindevice-flow polling loops for harness setup — useGH_TOKEN.