Local Dev
@skunk-ape/local-devv2026.11.06.1
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.
02Behaviors
@skunk-ape/local-dev/labv2026.11.04.1lab.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiKey? | string | A 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.
| Argument | Type | Description |
|---|---|---|
| numbers? | array | Issues to read by number. Always one request each, whatever bodyLimit is. |
| since? | string | ISO 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? | array | Selects issues in these statuses, most recently updated first. |
| bodyLimit? | number | Characters 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? | number | Stop 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
| Argument | Type | Description |
|---|---|---|
| token | string | A 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
| Argument | Type | Description |
|---|---|---|
| baseUrl? | string | The Forgejo server. |
| token? | string | A 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 Versions
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
behavior-spelling1 accepted
- (extension) — Written with the current behavior spelling on purpose. Installing needs a swamp client from after the rename.
06Platforms
07Labels