---
title: Pull requests pane
description: Browse the repository's open pull requests beside the chat and approve, comment, request changes or merge through the GitHub CLI.
section: plugins
order: 130
audience: [user]
sources: [plugins/github-prs/README.md, plugins/github-prs/src, plugins/github-prs/AGENTS.md]
features: [plugins.github-prs]
---

The `github-prs` plugin (built into the CLI) lists the open pull requests of the repository you run venom in, in a pane beside the chat. Everything goes through the GitHub CLI (`gh`): its login, its hosts (GitHub Enterprise included) and its rules. venom handles no token.

## Quick start

```bash
gh auth login        # once
venom                # then ctrl+g p, or /prs
```

## Keys

| Key | Where | What |
|---|---|---|
| `ctrl+g p` | anywhere | open or close the pane |
| `/prs`, `/prs left`, `/prs right` | editor | the same; a side opens there and is saved |
| `↑` `↓` `j` `k`, `PgUp` `PgDn`, `g` `G` | list | move |
| `Enter` | list | the PR: description, checks, reviews, unresolved threads, files, recent comments |
| `Esc`, `Backspace` | detail, diff | back; in the list, close |
| `f` | list | filter: all, mine, review requested |
| `d` | list, detail | the diff |
| `o` | list, detail | open in the browser |
| `a`, `c`, `r` | list, detail | approve, comment, request changes (a message is required) |
| `m` | list, detail | merge: `s` squash (default), `m` merge commit, `r` rebase; `d` toggles deleting the branch (on) |
| `R` | anywhere | refresh |
| `q` | anywhere | close |

## Safety

- Approve, comment, request changes and merge each end in a confirmation that states exactly what will be sent; only `y` sends.
- The PR is fetched again before the confirmation, and a merge carries `--match-head-commit <sha>`, so GitHub refuses it if someone pushed in between.
- Merging past failing checks, conflicts, a draft, requested changes or branch protection needs `O` (shift+o) first; the confirmation then starts with `OVERRIDE:`.
- The plugin registers no tool: the agent cannot read the pane or act through it.
- Network only while the pane is open: refresh on open (a 30-second cache answers a quick reopen) and every 60 seconds while open; none during a confirmation or after a rate limit.
- Remote text is stripped of escape sequences, control, bidi and zero-width characters, and `gh` gets an argument list, never a shell string.

## Configuration

```yaml
ui:
  pr_pane:
    side: right          # right | left
    width: 60            # columns, or "45%"
    auto_refresh: true   # true (60 s) | false | seconds
```

On the right the pane uses the margin a wide terminal leaves (146+ columns at the default 100-column chat) and swaps places with the agents panel; narrower, it overlays the top right. On the left it overlays the chat.

## Errors

| State | What to do |
|---|---|
| not a git repository | open venom in one |
| no GitHub remote | add one, or `gh repo set-default` |
| gh not installed | install the GitHub CLI, then `gh auth login` |
| not logged in | `gh auth login` (`--hostname <host>` for Enterprise), then `R` |
| rate limited | wait; nothing retries in the background |

## Limitations

One repository; 50 open PRs per filter; no inline review comments or thread replies.
