Expand description
Open PRs in WhoIsWorkingOn (docs/specs/SPEC_AGENT_OVERLAP_AWARENESS_2026_10_10.md
§3.5). They come from GitHub, so they cover agents on every computer. They
are read through this agent’s own gh-agent (srv holds no GitHub
credential), credited to the agent named by the <Agent>@<host>: title
prefix CI requires, and cached for 2 minutes per repository. A PR without
that prefix (a person’s or a bot’s, which the prefix rule exempts) is
credited to its GitHub author, with no host.
Structs§
Constants§
- CACHE_
TTL 🔒 - FILES_
NAMED 🔒 - Files named in one match’s detail; the rest are counted.
- GH_
AGENT 🔒 - GH_
TIMEOUT 🔒 - LIST_
LIMIT 🔒 gh pr list --limitis a cap on results, not a page size: high enough for every open PR of any repository here.- PR_
FIELDS 🔒
Functions§
- cache 🔒
- files_
phrase 🔒 - merge_
into 🔒 - Add
matchestobody.agentsasprmatches: to the local agent of that name when the PR is from this computer, else as an agent of its own (channel: "github"). - open_pr 🔒
- PR
numberofreporead on its own (gh pr view), when it is open: for a PR asked about by number that the list didn’t hold. - open_
prs 🔒 - The repository’s open PRs, from the cache when it is under 2 minutes old.
- parse_
pr 🔒 - One PR of
gh’s JSON. - parse_
pr_ 🔒list gh pr list --json number,title,headRefName,files,author’s output.- pr_
matches 🔒 - The open PRs that touch what was asked, each credited to its agent. The
caller’s own PRs (same agent and host) are left out.
Errwhenprnames no open PR here. - run_
gh_ 🔒agent gh-agent <args>’s output, killed afterGH_TIMEOUT.- this_
host 🔒 - This computer’s name, as the
<Agent>@<host>prefix writes it. - title_
author 🔒 AgentY@narko: fix(x): …→("AgentY", "narko").- under 🔒
Type Aliases§
- Cache 🔒
- Repository → when its PRs were read, and them.