espennilsen/github

GitHub — pi-github Extension

The pi-github extension provides /gh-* commands for common GitHub operations. All commands also work as /github-* variants.

Prerequisites

• gh CLI installed and authenticated
• For repo-scoped commands: run from a git repo, or specify the repo

Commands + Agent Tools

The pi-github extension provides /gh-* commands for user-initiated operations and LLM tools for agentic workflows (PR review thread resolution).

Commands

| Command | What it does | |---------|-------------| | /gh-prs [mine\|review-requested] [repo] | List open PRs | | /gh-issues [mine\|label:name] [repo] | List open issues | | /gh-status [repo] | Repo dashboard: PRs, issues, CI, branch PR | | /gh-actions [branch] [repo] | Recent workflow runs | | /gh-notifications | Unread GitHub notifications | | /gh-pr-create [base] | Create PR with LLM-generated summary | | /gh-pr-review [number\|repo#N\|URL] | Show PR review feedback | | /gh-pr-fix [number\|repo#N\|URL] | Fix unresolved review threads | | /gh-pr-merge [number\|repo#N\|URL] [--squash\|--merge\|--rebase] | Merge PR + full cleanup |

PR Thread Tools (for agents fixing review feedback)

| Tool | Purpose | |------|---------| | github_review_thread_reply | Reply to a PR review thread (thread_id, message) | | github_resolve_review_thread | Mark a review thread as resolved (thread_id) | | github_post_pr_comment | Post a summary comment on a PR (owner, repo, pr_number, body) |

Repo Reference Syntax

Commands accept flexible repo/PR references anywhere in args:

| Format | Example | |--------|---------| | GitHub URL | https://github.com/owner/repo/pull/123 | | Owner/repo#N | espennilsen/pi#96 | | Repo#N (with default owner) | pi#96 | | Owner/repo | espennilsen/pi | | Plain number | 96 | | No args | Auto-detect from current branch |

Default Owner

Set in settings.json to skip typing the owner:

{ "pi-github": { "defaultOwner": "espennilsen" } }

Detailed Workflows

For complex PR operations, see the reference docs:

• Fixing PR review threads — references/pr-fix.md Read when fixing unresolved review feedback, resolving threads, or using /gh-pr-fix.

• Parallel PR fixes — references/pr-fix-parallel.md Read when fixing review feedback across multiple PRs simultaneously using parallel subagents (pool or orchestrator mode).

• Merging PRs — references/pr-merge.md Read when merging a PR, resolving merge conflicts, cleaning up branches/worktrees, or using /gh-pr-merge.

• Creating PRs — references/pr-create.md Read when creating a PR with a generated summary, or using /gh-pr-create.

Raw gh CLI

For anything the commands don't cover:

# Structured output
gh pr list --json number,title --jq '.[] | "#\(.number) \(.title)"'

# GraphQL
gh api graphql -f query='{ viewer { login } }'

# API calls
gh api repos/owner/repo/contributors --jq '.[].login'

Conventions

• Default merge strategy: squash
• Tag releases as v<semver>
• Use --json + --jq for structured output
• Always use worktrees for feature branches — never git checkout in main dir