---
name: open-pull-request
description: 'Open a GitHub pull request from the current branch, filling the repo PR template. Use when the user wants to open, create, or raise a PR — to the default base branch or a branch they name. Triggers on "open a PR", "create a pull request", "raise a PR to <branch>", "PR this branch".'
allowed-tools: Bash(git *), Bash(gh *), Read
---

# Open Pull Request

Open a PR from the current branch with `gh`, filling `.github/pull_request_template.md` from the actual diff.

## Steps

1. **Resolve head and base.** Head = `git branch --show-current`. Base = the branch the user named, else the remote default from `git symbolic-ref refs/remotes/origin/HEAD`. If head equals base, stop — there is nothing to PR; tell the user to switch to a feature branch. Done when you hold a head and base that differ.

2. **Push the branch.** Run `git push -u origin HEAD`. Done when the head branch has an upstream on origin.

3. **Reuse an existing PR.** Run `gh pr view --json url,state`. If it returns an open PR for this branch, report the URL and stop. Done when no open PR exists.

4. **Draft the body from the template.** Read `.github/pull_request_template.md` and fill **every** section from the real change — `git log <base>..HEAD` and `git diff <base>...HEAD --stat`:

   Keep it terse: bullets, not prose. Done when no template placeholder comment (`<!-- … -->`) survives.

5. **Create the PR.** Write the body to a temp file, then run `gh pr create --base <base> --title "<title>" --body-file <file>`, where title is a concise summary drawn from the commits. Report the returned URL. Done when `gh` returns a PR URL.