Pull requests pane
Browse the repository's open pull requests beside the chat and approve, comment, request changes or merge through the GitHub CLI.
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
gh auth login # once
venom # then ctrl+g p, or /prsKeys
| 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
ysends. - 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 withOVERRIDE:. - 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
ghgets an argument list, never a shell string.
Configuration
ui:
pr_pane:
side: right # right | left
width: 60 # columns, or "45%"
auto_refresh: true # true (60 s) | false | secondsOn 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.