Skip to main content

Local Dev

@skunk-ape/local-devv2026.11.06.1· MIT· 12d agoBEHAVIORSACCEPTED WARNINGS
01README

Tracker and forge reads for local development, shaped so an agent can rerun them cheaply: one call, one record, one fixed shape.

lab reads Swamp Club Lab issues by number, by status, or by what changed since a cursor. Bodies are trimmed visibly, with the original size and the exact input that returns them whole, and a failed read is reported per issue.

github and forgejo read a list of pull requests, across repositories, into one shape: state, mergeability, and checks as counts plus only the failures.

Read-only. Reads what the token or API key can see. Lab and Forgejo read public data without one; GitHub requires a token.

02Behaviors3
@skunk-ape/local-dev/labv2026.11.04.1lab.ts

Global Arguments

ArgumentTypeDescription
apiKey?stringA Swamp Club API key, from a vault. Without one, only public issues can be read.
userAgent?string
fn issues(numbers?: array, since?: string, status?: array, bodyLimit?: number, maxIssues?: number)
Read Lab issues by number, by status, or by what changed since a cursor, into one record with bodies trimmed visibly. Bodies take one request per issue; bodyLimit 0 skips them for issues selected by since or status.
ArgumentTypeDescription
numbers?arrayIssues to read by number. Always one request each, whatever bodyLimit is.
since?stringISO time. Selects issues updated at or after it, across statuses unless `status` narrows them. To follow changes, pass the `asOf` of the latest `changes` record.
status?arraySelects issues in these statuses, most recently updated first.
bodyLimit?numberCharacters of body to keep per issue. 0 omits bodies, and skips their requests for issues selected by `since` or `status`. null keeps them whole.
maxIssues?numberStop here and set `truncated`.

Resources

digest(infinite)— The issues the last `issues` run selected. Instance `changes` for a `since` read across all statuses, so other reads can't replace its cursor; `digest` otherwise.
@skunk-ape/local-dev/githubv2026.11.06.1github.ts

Global Arguments

ArgumentTypeDescription
tokenstringA GitHub token, from a vault. Required: GitHub's GraphQL API refuses requests without one.
userAgent?string
fn pr_state()
Read GitHub PRs, across repositories, into one record: state, mergeability, and checks as counts plus only the failures. Failed reads are listed per PR.
@skunk-ape/local-dev/forgejov2026.11.06.1forgejo.ts

Global Arguments

ArgumentTypeDescription
baseUrl?stringThe Forgejo server.
token?stringA Forgejo token, from a vault. Without one, only public repositories can be read.
userAgent?string
fn pr_state()
Read Forgejo PRs, across repositories, into one record: state, mergeability, and checks as counts plus only the failures. Failed reads are listed per PR.
03Previous Versions1
2026.11.04.1MIT
04Stats
A
100 / 100
Downloads
2
Archive size
30.2 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

06Platforms
07Labels