| name | pr |
| description | Create a pull request for the current branch using GitHub CLI. Use after committing changes when ready to open a PR. |
| allowed-tools | Bash |
Create Pull Request
Create a pull request for the current branch against main using the GitHub CLI.
Instructions
- Run
git statusto check for uncommitted changes (warn if any exist) - Check if the branch has an upstream and is pushed
- Run
git log main..HEAD --onelineto see all commits in this branch - Run
git diff main...HEAD --statto understand the full scope of changes - Create a PR with
gh pr create
PR Format
Use a HEREDOC for the body to ensure proper formatting:
gh pr create --title "<concise title>" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points describing what this PR does>
## Test plan
- [ ] <how to verify this works>
EOF
)"
Title Guidelines
- Keep under 72 characters
- Use imperative mood ("Add feature" not "Added feature")
- Be specific about what changed
Body Guidelines
- Summary: 1-3 bullet points explaining what and why
- Test plan: Checklist of verification steps
Pre-flight Checks
Before creating the PR:
- Ensure all changes are committed
- Ensure branch is pushed to remote
- If not pushed, run
git push -u origin HEADfirst
Example
gh pr create --title "Fix cron machine image updates in CI/CD" --body "$(cat <<'EOF'
## Summary
- Fix CI/CD to explicitly pass --image when updating cron machines
- Cron machines created via `flyctl machine run` don't auto-update with app releases
- Fetches image from deployed app machines and passes it to machine update
## Test plan
- [ ] Deploy to staging and verify cron machine gets updated
- [ ] Check cron logs after next scheduled run
EOF
)"
After Creation
Return the PR URL so the user can review it.