gh Plugin
GitHub ecosystem integration with streamlined git workflows, Copilot coding agent configuration, and multi-CI migration tools.
Installation
claude plugin install zircote/gh
Verify Installation
After installing, verify the commands and agent are available:
# Test git workflow command (dry run)
claude "/gh:prune"
# Verify gh CLI is authenticated
gh auth status
# Test Copilot onboarding (shows help without modifying files)
claude "What does the /gh:copilot-onboard command do?"
You should see the prune command show stale branches (if any) and confirmation that gh CLI is authenticated.
Contents
| Component | Count | Description |
|---|
| Commands | 12 | Git workflow and GitHub integration commands |
| Agents | 1 | Copilot onboarding specialist |
| Skills | 1 | GitHub ecosystem configuration |
Commands
Git Workflow Commands
| Command | Description | Arguments |
|---|
/gh:cp | Stage, commit, and push all changes | - |
/gh:pr | Create a pull request via gh CLI | [to-branch] [from-branch] |
/gh:fr | Fetch and rebase onto remote branch | [remote] [branch] |
/gh:sync | Full sync: fetch, rebase, push | [remote] [branch] |
/gh:ff | Fast-forward merge only | [remote] [branch] |
/gh:prune | Clean up stale local branches | [--force] |
Copilot, Migration & Review Commands
| Command | Description | Arguments |
|---|
/gh:copilot-onboard | Configure repo for GitHub Copilot coding agent | [repository-path] |
/gh:onboard | Alias for copilot-onboard | [repository-path] |
/gh:migrate | Migrate multi-CI to GitHub Actions | [--ci=TYPE] |
/gh:ci-assist | Onboard repository to GitHub ecosystem | - |
/gh:pr-fix | Complete PR remediation workflow | [pr-number] |
/gh:review-comments | Process PR review comments with assessment & remediation | [pr-number] [--auto|--interactive] |
Command Details
/gh:cp - Commit and Push
Stages, commits, and pushes all changes with smart commit message generation:
/gh:cp
Features:
- Reviews all changes for sensitive data (API keys, credentials)
- Generates conventional commit messages (
feat:, fix:, refactor:, etc.)
- Splits new files and modifications into separate commits
- Never adds AI attribution signatures
/gh:pr - Create Pull Request
Creates a pull request using the GitHub CLI:
/gh:pr # PR to main from current branch
/gh:pr develop # PR to develop from current branch
/gh:pr main feature/auth # PR to main from feature/auth
Requires: gh CLI installed and authenticated
/gh:fr - Fetch and Rebase
Fetches from remote and rebases current branch:
/gh:fr # Rebase onto origin/current-upstream
/gh:fr upstream # Rebase onto upstream/...
/gh:fr origin main # Rebase onto origin/main
Includes conflict resolution guidance if rebase fails.
/gh:sync - Full Sync Cycle
Complete synchronization: fetch, rebase, and push with confirmation:
/gh:sync
/gh:sync origin main
Features:
- Pre-flight checks for uncommitted changes
- Shows incoming commits before rebasing
- Confirms before pushing
- Conflict resolution assistance
/gh:ff - Fast-Forward Only
Updates branch via fast-forward merge (no history rewriting):
/gh:ff
/gh:ff origin main
Fails gracefully if fast-forward isn't possible, offering alternatives.
/gh:prune - Clean Up Branches
Removes stale local branches that have been merged or deleted on remote:
/gh:prune # Dry run - shows what would be deleted
/gh:prune --force # Actually delete stale branches
/gh:copilot-onboard - Copilot Configuration
Configures a repository for GitHub Copilot coding agent:
/gh:copilot-onboard
/gh:copilot-onboard /path/to/repo
Generates:
.github/copilot-instructions.md - Repository-wide instructions.github/workflows/copilot-setup-steps.yml - Environment setup.github/instructions/*.instructions.md - Scoped instructions
Cross-references with existing CLAUDE.md to avoid duplication.
/gh:migrate - CI Migration
Migrates from various CI systems to GitHub Actions:
/gh:migrate # Auto-detect CI system
/gh:migrate --ci=jenkins # Migrate from Jenkins