Skip to main content

Github

@webframp/githubv2026.10.14.1· Apache-2.0(was none)· 17d agoBEHAVIORS
01README

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

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/repo

Methods

  • 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
02Release Notes

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.

03Behaviors1
@webframp/githubv2026.10.14.1github/repos.ts
fn list_repos()
List repositories for the authenticated user with basic metadata
fn get_repo_info()
Get detailed information about a specific repository including stats and metadata
fn list_prs()
List pull requests for a repository with optional state filter
fn list_issues()
List issues for a repository with optional state filter
fn list_releases()
List releases for a repository
fn list_workflows()
List recent workflow runs for a repository

Resources

repos(30m)— List of repositories for the authenticated user
repo_info(30m)— Detailed information about a specific repository
pull_requests(15m)— List of pull requests for a repository
issues(15m)— List of issues for a repository
releases(1h)— List of releases for a repository
workflow_runs(10m)— List of recent workflow runs for a repository
triageIssue(30m)— Exact GitHub issue context for triage
triagePullRequest(15m)— Exact GitHub PR context for triage
triageAction(30d)— GitHub triage action evidence
04Previous Versions18
2026.10.12.1

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

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

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

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

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

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

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

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

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

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

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

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

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

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.06.21.1
2026.06.15.1
2026.05.14.1
2026.04.22.1

updated platforms

05Stats
A
100 / 100
Downloads
1,186
Archive size
18.0 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
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels