@gwynnnplaine/pi-github

Read GitHub issues, PRs, diffs, checks & code from inside Pi — via the gh CLI. Chronological markdown, image extraction, PR review workflows.

Packages

Package details

extension

Install @gwynnnplaine/pi-github from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@gwynnnplaine/pi-github
Package
@gwynnnplaine/pi-github
Version
0.3.2
Published
May 31, 2026
Downloads
not available
Author
gwynnnplaine
License
MIT
Types
extension
Size
87.1 KB
Dependencies
0 dependencies · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/gwynnnplaine/pi-github/main/assets/banner.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

License Pi extension npm GitHub

Fork of the archived maria-rcks/pi-github, continued under @gwynnnplaine.

A simple, reliable GitHub tool for your agents. Wraps the gh CLI you already have.

  • Markdown-formatted output. LLMs read it far better than raw JSON.
  • Infers the repo from git remote origin, so neither you nor the agent fusses with owner/repo.
  • Handles pictures — lists and downloads image attachments from issues and PRs.

Just tell Pi review #1234 and it works.

Install

pi install npm:@gwynnnplaine/pi-github
# or
pi install git:github.com/gwynnnplaine/pi-github
# or
pi install /absolute/path/to/pi-github

Requires gh

  • Install gh and put it on PATH.
  • Authenticate once: gh auth login.
  • Skip owner/repo. They're inferred from git remote origin.

Use

Ask Pi in plain language. It routes to the github tool.

"review #1234"
"list open PRs"
"PR overview for 88 — files, reviews, checks"
"show the diff for src/index.ts in PR 88"
"read src/index.ts from main"
"search the repo for 'fetchThread'"

Pass owner/repo to target another repo; omit them to use the current one.

Actions

One tool, github. Pick an action — default is format.

Action Does Scope
format Thread → chronological markdown. Filters: author, kind, since, until, contains issue / PR / discussion
list_issues Open issues, paginated repo
list_prs Open PRs, paginated repo
list_images Image references in a thread thread
download_image Download one image by imageId thread
list_changes Changed files + change IDs PR
get_change One file's diff by changeId PR
list_participants Everyone who touched the thread thread
list_review_comments Review comments. Filters: author, path, since, until PR
list_pr_commits Commits in the PR PR
get_pr_commit One commit's diff by commitSha PR
list_pr_checks CI / check status PR
pr_overview Summary: files + reviews + checks. Toggle with includeFiles/includeReviews/includeChecks PR
read_file Remote file content. Options: startLine, endLine, ref repo
list_directory Remote directory listing. Option: ref repo
search_code Code search. Option: path repo
glob_files Match the repo tree by filePattern. Options: offset, limit, ref repo
search_commits Commit history search by query, author, since, until repo

Params

  • owner, repo — optional; inferred from git remote origin.
  • id — thread number (issue / PR / discussion). Legacy alias number still works.
  • entity — issue | pr | discussion. Auto-detected when omitted.

Links