@gwynnnplaine/pi-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

• Repository: https://github.com/gwynnnplaine/pi-github
• Issues: https://github.com/gwynnnplaine/pi-github/issues