Skip to main content
← back to extensions

Github

@webframp/githubv2026.09.15.1· 1d agoMODELS
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
02Release Notes

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.

03Models1
@webframp/githubv2026.09.15.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 Versions17
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 models

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

2026.04.13.1
2026.04.12.1
05Stats
A
100 / 100
Downloads
285
Archive size
18.7 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
Repository
https://github.com/webframp/swamp-extensions
06Platforms
07Labels
#api#devops#git#github#issues#pulls#repos