blob: f0f927249f778e89ad7949404027e00c0ac59d51 [file] [view]
# PR Queue Plugin
Side panel UI (`sidecar://pr-queue/pr_queue/`) showing pending GitHub pull
requests with buttons to launch manual code reviews in isolated Git worktrees.
## Behavior
- Displays open GitHub PRs filtered by review status, author, draft state, age,
or custom search query using the `gh` CLI.
- Fetches on demand without automatic reviews or background polling.
- Looking up a number shows live PR details (or detects asynchronously if a
missing number is an issue), matching review chats, and launch actions.
- Clicking a PR review button creates or updates a dedicated Git worktree at the
PR head commit and starts a new conversation running
`.agents/skills/review-code/SKILL.md`.
## Requirements
- Python 3.13 or higher on `PATH`.
- Authenticated `gh` CLI (`gh auth status`) with access to the target repo.
- A local Git clone of the target repo containing an `upstream` (or `origin`)
remote so review worktrees can be created from `refs/pull/<N>/head`.
- Global registration in `~/.gemini/config/plugins/pr-queue` (for example via a
symlink to this directory) so the agent IDE starts `pr-queue/pr_queue`.
## Files
- `plugin.json`: Plugin manifest.
- `rules/AGENTS.md`: Rule surfacing `[📋 PR Queue](sidecar://pr-queue/pr_queue/)`
when `/pr-queue` is requested.
- `skills/pr-queue/SKILL.md`: `/pr-queue` skill instructions.
- `sidecars/pr_queue/BUILD.bazel`: Bazel library and test targets for the
sidecar.
- `sidecars/pr_queue/sidecar.json`: Sidecar registration and UI view config.
- `sidecars/pr_queue/fetch_pr_queue.py`: `gh`-based PR queue fetcher and
filter CLI.
- `sidecars/pr_queue/state_store.py`: Validated config and JSON state storage.
- `sidecars/pr_queue/git_worktree.py`: Git repo detection and PR worktree setup.
- `sidecars/pr_queue/ls_client.py`: Loopback Language Server RPC client.
- `sidecars/pr_queue/server.py`: HTTP backend serving the UI, cached PR queue,
PR/issue and review chat lookup, and worktree/chat launcher.
- `sidecars/pr_queue/index.html`: Adaptive dark/light side panel frontend.
- `sidecars/pr_queue/fetch_pr_queue_test.py`: Unit tests for `fetch_pr_queue`.
- `sidecars/pr_queue/server_test.py`: Unit tests for `server`, `state_store`,
`git_worktree`, and `ls_client`.