Skip to content
Docs menu

Pull requests pane

Browse the repository's open pull requests beside the chat and approve, comment, request changes or merge through the GitHub CLI.

View .md

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 /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

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.