amp - GitHub CLI extension for PR approval/merge/pull workflow

[chicks-net]

Project Idea

Create a GitHub CLI extension called amp that streamlines the PR review workflow by providing an interactive interface to approve, merge, and pull PRs.

Problem Statement

Reviewing and merging PRs involves checking multiple things:

• What PRs are available?
• What do the CI/CD checks show?
• Are the changes safe to merge?

Currently this requires multiple gh commands or browser visits. Theres no single streamlined workflow that combines listing, viewing status, and taking action.

Proposed Solution

Build a gh extension that:

• Lists available PRs (configurable filters: repo, author, labels, etc.)
• Shows GitHub Actions status using gh observer or similar
• Provides interactive selection (checkboxes/fzf-style)
• Prompts for approve/merge/pull decisions
• Handles the full workflow: approve → merge → pull locally

Technical Considerations

• Extension Type: gh CLI extension (gh-amp)
• Language: Bash should be enough for this application.
• UI: Interactive TUI with bubbletea or similar
• Status Checks: Integrate with gh run list / gh run view or use gh observe pattern
• Concurrency: Support selecting multiple PRs for batch operations

Key Features

1. gh amp status - Show CI status for selected PR(s)
2. gh amp review - Interactive workflow: select → view status → approve/merge/pull

Deliverables

• Installable gh extension (gh extension install fini-net/gh-amp)
• Interactive TUI for PR management
• Integration with GitHub Actions status
• Configuration for default workflows and preferences
• Documentation with examples

[chicks-net]

https://github.com/jackchuka/gh-dep looks like it might already do what I want here. shmokmt/gh-approve-deps is another attempt at this, but it doesn't look as close to what I had in mind at this point.

[chicks-net]

Sadly gh-dep did not recognize my Renovate PRs so I may have to build this myself. 😦

[chicks-net]

@claude can we create a github extension that is written in bash?

[claude]

Claude finished @chicks-net's task in 31s —— View job

---

Answering: Can we create a gh extension in Bash?

• Gather context
• Understand request
• Formulate answer

---

Yes, absolutely! Bash is a first-class option for gh CLI extensions, and it's actually the simplest way to get started.

How it works

A bash gh extension is just an executable shell script named gh-amp inside a directory called gh-amp. The gh CLI handles installation and calling it as gh amp.

gh-amp/
├── gh-amp          # the main bash script (executable)
└── README.md

To scaffold one:

gh extension create gh-amp   # creates a bash extension by default

Or manually:

mkdir gh-amp
cat > gh-amp/gh-amp <<'EOF'
#!/usr/bin/env bash
set -euo pipefail

# gh amp - PR approve/merge/pull workflow
# gh and all its subcommands are available here
gh pr list "$@"
EOF
chmod +x gh-amp/gh-amp

What bash gets you for free

Since the script runs inside a shell with gh already in PATH, you can use the full gh API directly:

gh pr list --json number,title,statusCheckRollup
gh pr review --approve
gh pr merge --squash
gh run list --limit 5

For the interactive TUI bits (fzf-style selection), you'd just call fzf as a dependency — many gh extensions do this pattern.

Real-world examples

Several popular gh extensions are pure bash:

• gh-dash started with shell scripting
• gh-poi — bash
• The gh extension create default template generates bash

Bottom line for gh-amp

The issue notes "Bash should be enough for this application" — that's correct. The workflow (list PRs → check CI status → approve/merge/pull) maps cleanly to gh subcommands chained in bash, with fzf for interactive selection. No need for bubbletea/Go unless you want a richer TUI.

---

[chicks-net]

Working in https://github.com/fini-net/gh-amp