pi-github
v0.2.0
Published
GitHub tool extension for Pi: format threads, list issues/PRs, and inspect PR diffs/images.
Maintainers
Readme
pi-github
GitHub extension package for Pi with thread formatting, issue/PR listing, image extraction, and PR diff inspection.
Install
Use whichever source you prefer:
pi install npm:pi-github
# or
pi install git:github.com/maria-rcks/pi-github
# or
pi install /absolute/path/to/pi-githubHow it works
- This extension calls the GitHub CLI (
gh) under the hood (gh api ...) to fetch issues, PRs, discussions, images, and diffs. ghmust be installed and available inPATH.ghmust be authenticated for the account you want to use (gh auth login).- If you do not pass
owner/repo, the tool tries to infer them fromgit remote origin.
What this package does
- Formats issues, pull requests, and discussions into chronological markdown.
- Lists open issues and pull requests with pagination support.
- Extracts image references and downloads a selected image by ID.
- Lists PR changed files and fetches per-file diffs.
- Provides PR workflow helpers (overview, checks, commits, review comments, participants).
- Adds remote repository read/search utilities (file read, directory list, code/commit search, glob files).
Tool actions
Tool name: github
format(default)- optional filters:
author,kind,since,until,contains
- optional filters:
list_issueslist_prslist_imagesdownload_imagelist_changes(PR only)get_change(PR only)list_participantslist_review_comments(PR only, supportsauthor/path/since/untilfilters)list_pr_commits(PR only)get_pr_commit(PR only, requirescommitSha)list_pr_checks(PR only)pr_overview(PR only, optionalincludeFiles/includeReviews/includeChecks)read_file(repo file content with optionalstartLine/endLine/ref)list_directory(repo directory entries with optionalref)search_code(repo code search with optionalpath)glob_files(repo tree glob filter withfilePattern, optionaloffset/limit/ref)search_commits(repo commit search usingqueryand optionalauthor/since/until)
Core params:
owner,repo(optional ifgit remote originpoints to GitHub)id(alias:number)entity:issue | pr | discussion(optional, auto-detected)
Links
- Repository: https://github.com/maria-rcks/pi-github
- Issues: https://github.com/maria-rcks/pi-github/issues
