GitHub adapter

2 min readFor operatorsUpdated 2026-05-19

What you'll do

Use the read-only GitHub adapter to load repo metadata, issues, PRs, and commit-status into case files. Writes are not part of the MVP adapter.

Read-only by design.

GitHub writes (issues · comments · branches · PRs) require future guarded write workflows and explicit capability grants. The shipped adapter never writes.

What the adapter reads

Repository metadata

Open issues

Open pull requests

Changed files for open PRs

Commit status for local HEAD

Build a case file

Mode

Command

Notes

With GitHub context

default

craik case build task_review_docs

Without GitHub network access

offline

craik case build task_review_docs --no-github

GitHub context is stored in the case file github_state field. If the project remote is not a GitHub repository, the API is unavailable, auth fails, or rate limits block reads, Craik records a warning and leaves an assumption instead of failing the case-file build.

What's next

GuideUsing case filesRead the assembled case file and inspect the github_state section.ReferenceGitHub configToken, scopes, and rate-limit posture.GuideCapability grantsWhy GitHub writes require grants and how the workflow will compose.