Security: see references/scanner-notes.md and upstream SECURITY.md for expected scanner signals and trust model.
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.
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-env/scripts/bootstrap.sh(or/verasic-setup-githubin Cursor, or let/verasic-initdo it). - User creates
.github-agent.localwithGH_TOKEN(never commit). - Verify:
bash .cursor/skills/verasic-github-env/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-env/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.