Github
Query GitHub data using the gh CLI for repository, PR, issue, release, and workflow visibility.
Authentication
Uses the gh CLI's built-in authentication. Run gh auth login to configure.
Required Tools
ghCLI (https://cli.github.com/) installed and authenticated
Usage
# Create github model
swamp model create @webframp/github github
# List your repos
swamp model method run github list_repos
# Get detailed repo info
swamp model method run github get_repo_info --input repo=owner/repo
# List open PRs
swamp model method run github list_prs --input repo=owner/repo
# List closed issues
swamp model method run github list_issues --input repo=owner/repo --input state=closed
# List releases
swamp model method run github list_releases --input repo=owner/repo
# List recent workflow runs
swamp model method run github list_workflows --input repo=owner/repoMethods
- list_repos - List repositories for the authenticated user
- get_repo_info - Get detailed information about a specific repository
- list_prs - List pull requests for a repository
- list_issues - List issues for a repository
- list_releases - List releases for a repository
- list_workflows - List recent workflow runs for a repository
- get_issue_context - Collect a bounded issue snapshot for triage
- get_pull_request_context - Collect a bounded PR snapshot with head SHA and checks
- create_issue - Create an approved triage issue
- add_issue_comment - Post an approved triage comment
- close_issue - Close an approved triage issue
- get_workflow_run - Read an exact workflow run
- retry_workflow_run - Retry an approved workflow run
- watch_pr_checks - Bounded-poll a PR's status checks to completion
- merge_pull_request - Post an approved merge comment and poll until merged
2026.10.14.1
Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.
Upgrade note: Metadata only. No code, schema, or behavioral changes.
2026.10.12.1
Fixed: Repeating an idempotencyKey on create_issue, add_issue_comment,
close_issue, retry_workflow_run, or a finished merge_pull_request no
longer fails the workflow step. These methods returned a handle with only a
name when the key had been seen before. The runtime rejected it
(expected string, received undefined (path: dataId)), so a scheduled workflow
whose detection persisted reported failure on every run. Dedup itself was
unaffected: no duplicate issue, comment, close, retry, or merge comment was
ever sent.
Changed: A repeated key now re-writes the existing triageAction record
unchanged and returns its full handle. Each repeat adds a version of that
record (retention is still 20 versions) whose 30-day lifetime starts from the
repeat, so a marker that a workflow keeps hitting stays current instead of
aging out from its first write. No gh command runs on a repeat.
Resources
2026.10.12.1
Fixed: Repeating an idempotencyKey on create_issue, add_issue_comment,
close_issue, retry_workflow_run, or a finished merge_pull_request no
longer fails the workflow step. These methods returned a handle with only a
name when the key had been seen before. The runtime rejected it
(expected string, received undefined (path: dataId)), so a scheduled workflow
whose detection persisted reported failure on every run. Dedup itself was
unaffected: no duplicate issue, comment, close, retry, or merge comment was
ever sent.
Changed: A repeated key now re-writes the existing triageAction record
unchanged and returns its full handle. Each repeat adds a version of that
record (retention is still 20 versions) whose 30-day lifetime starts from the
repeat, so a marker that a workflow keeps hitting stays current instead of
aging out from its first write. No gh command runs on a repeat.
2026.09.18.1
Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the
repo. No behavioral changes in this extension.
2026.09.15.1
Changed: Bump zod 4.4.3 → 4.6.5
2026.09.08.1
Added: Bounded triage context collection and explicit issue, comment, close, and workflow-run actions for approval-gated orchestration.
Upgrade note: Existing model resources are unchanged.
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.09.08.1
Added: Bounded triage context collection and explicit issue, comment, close, and workflow-run actions for approval-gated orchestration.
Upgrade note: Existing model resources are unchanged.
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
Modified 1 behaviors
2026.08.28.1
Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.
Upgrade note: License text only. No API, schema, or runtime behavior changed.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.3
Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry
quality scorer can resolve dependencies and score the extension. An earlier
release used a bare "zod" import-map specifier, which published but scored as
unscored.
Changed: Retained explicit compilerOptions.strict in deno.json. No
behavioral or schema changes.
2026.08.26.1
Fixed: Added missing description field to upgrade entry for version
2026.08.24.2. The omission caused swamp extension pull to fail with a catalog
validation error ("upgrades.N.description: Invalid input: expected string,
received undefined").
2026.08.25.1
Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.
updated labels
2026.08.24.3
Added: Output metadata attributes for observability.
durationMs: Method execution duration in milliseconds.collectedBy: Extension name that produced the data.fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.24.2
Added Troubleshooting section documenting hardcoded pagination caps without truncated indicator, gh CLI auth delegation, no retry logic, JSON trust-cast, and GitHub Enterprise configuration.
2026.08.21.2
Changed: The repo argument on get_repo_info, list_prs, list_issues,
list_releases, and list_workflows is now validated as an owner/name slug up
front; previously an invalid value (missing slash, bare name, extra path
segments) passed schema validation and only failed deep inside the gh CLI with
a cryptic error. gh command failures now name the exact command that was run
and include its exit code, instead of a bare "gh command failed: ..." message.
A non-JSON response from gh (e.g. an unexpected CLI warning printed to
stdout) now raises a clear "returned output that could not be parsed as JSON"
error naming the command, instead of a raw JSON.parse SyntaxError.
2026.08.21.1
Changed: Added .describe() documentation to every previously undocumented field in the
resource schemas (RepoSchema, RepoListSchema, RepoInfoSchema, PullRequestSchema,
PullRequestListSchema, IssueSchema, IssueListSchema, ReleaseSchema, ReleaseListSchema,
WorkflowRunSchema, WorkflowRunListSchema). No schema or behavioral changes — a no-op
upgrades entry was added to keep the model's typeVersion tracking in sync with the version bump.
2026.07.18.1
Added: An upgrades array entry (no-op) to repos.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.16.1
Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.
2026.08.21.1
Changed: Added .describe() documentation to every previously undocumented field in the
resource schemas (RepoSchema, RepoListSchema, RepoInfoSchema, PullRequestSchema,
PullRequestListSchema, IssueSchema, IssueListSchema, ReleaseSchema, ReleaseListSchema,
WorkflowRunSchema, WorkflowRunListSchema). No schema or behavioral changes — a no-op
upgrades entry was added to keep the model's typeVersion tracking in sync with the version bump.
2026.07.18.1
Added: An upgrades array entry (no-op) to repos.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.16.1
Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.
2026.07.18.1
Added: An upgrades array entry (no-op) to repos.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.
2026.07.16.1
Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.
2026.07.16.1
Changed: README and LICENSE reformatted (deno fmt) in PR #134; this is the first version bump to publish that formatting to the registry. No functional or behavioral change.
updated platforms
- 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
- License2/2earned
- Verified public repository2/2earned