Github
@goodcraft/githubv2026.06.14.1
01README
GitHub management — create repositories, releases, and pull requests via the GitHub REST API (Octokit). Read-only sync plus idempotent ensureRepo / ensureRelease / openPr, each dryRun by default.
02Models
@goodcraft/githubv2026.06.14.1github.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| token | string | |
| owner | string | |
| isOrg | boolean | |
| baseUrl | string |
fn sync()
List the repositories owned by `owner` (read-only; proves the token)
fn ensureRepo(name: string, description?: string, private: boolean, autoInit: boolean, licenseTemplate?: string, gitignoreTemplate?: string, homepage?: string, topics: array, dryRun: boolean)
Idempotently ensure a repository exists (create it if missing). dryRun=true (default) plans without creating.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| description? | string | |
| private | boolean | |
| autoInit | boolean | |
| licenseTemplate? | string | |
| gitignoreTemplate? | string | |
| homepage? | string | |
| topics | array | |
| dryRun | boolean |
fn ensureRelease(repo: string, tagName: string, targetCommitish?: string, name?: string, body?: string, draft: boolean, prerelease: boolean, dryRun: boolean)
Idempotently ensure a release+tag exists (skip if a release with the tag is already present). dryRun=true (default) plans without creating.
| Argument | Type | Description |
|---|---|---|
| repo | string | |
| tagName | string | |
| targetCommitish? | string | |
| name? | string | |
| body? | string | |
| draft | boolean | |
| prerelease | boolean | |
| dryRun | boolean |
fn openPr(repo: string, head: string, base: string, title: string, body?: string, draft: boolean, dryRun: boolean)
Idempotently open a pull request (skip if an open PR for the same head→base already exists). dryRun=true (default) plans without creating.
| Argument | Type | Description |
|---|---|---|
| repo | string | |
| head | string | |
| base | string | |
| title | string | |
| body? | string | |
| draft | boolean | |
| dryRun | boolean |
Resources
repos(infinite)— Snapshot of the repositories owned by `owner`
repoEnsure(infinite)— Result of the last ensureRepo call
release(infinite)— Result of the last ensureRelease call
pull(infinite)— Result of the last openPr call
03Stats
A
100 / 100
Downloads
0
Archive size
41.3 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
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
04Platforms
05Labels