Skip to content
Browse docs
Docs / Direct your agents

GitHub

Annsa reads your repo for context and matches your PRs to priorities. It never writes code.

01 Connect the repo

Go to Settings, then Integrations, then GitHub, and click Connect. Authorize Annsa and pick a repository.

02 Context for the spec

With GitHub connected, your agent gets your repo's context with each spec: the tech stack, likely files to touch, related pull requests and your CLAUDE.md or .cursorrules. Annsa refreshes it when you pick the repo and after merges to your default branch.

03 PRs on a priority

Put an Annsa-Spec: <spec id> line in the PR body, with a spec id (build_xxxxxxxx) or #N. Annsa links the PR to the priority. When the PR merges into your live branch, Annsa marks the priority shipped on its own only if every Done When line has proof. If a line has none, Annsa adds a note and leaves the priority unshipped.

Your call: merge the PR. Annsa doesn't.

04 What it never does

Annsa never changes your code, and shipping never deploys. The only thing it writes to GitHub is an issue, on demand or automatically if you turn that on.

05 Disconnecting

Go to Settings, then Integrations, and click Disconnect. Your agent stops getting repo context, and pull requests stop matching.

Next guideSpecs