Connect a repository

Ask your agent to connect a GitHub repository as an Equall project — no dashboard step needed.

"Connect the repo acme/dashboard to Equall."

Re-connecting a repo that's already an Equall project is safe: the agent just gets the existing project back, nothing is duplicated.

Connecting also assigns the project its issue tag prefix — a short code derived from the repo name (e.g. acme/dashboard → DAS). Every issue found later is referenced as PREFIX-N (DAS-12), the shared handle you and the agent use to talk about it.

This connects only — it doesn't scan. Once a repo is connected, ask for a scan next.

Public vs private repos

• Public repos resolve automatically from their owner/name.

• Private repos need their GitHub numeric id, because the connect step never handles a GitHub token. Have the agent fetch it first:

  gh api repos/owner/name --jq .id

  Then pass that id when connecting.

Limits

• One connect attempt per minute. If the agent hits the limit (e.g. retrying a typo'd repo name), have it wait a minute and try again — a rejected repo name doesn't count against it.

Multiple workspaces

If you belong to more than one workspace, tell the agent which one to connect the repo into:

"Connect acme/dashboard to Equall in my Acme workspace."

With a single workspace, it's picked automatically.