revman.nvim

November 11, 2025 · View on GitHub

The core workflow is simple:

Add a PR to your local database.
Browse PRs (especially those "waiting for review") using Telescope.
Open the PR in Octo.nvim for a full-featured review.
Mark the PR as "waiting for changes" when you’re done.
Optionally add a note for future references outside of comments.
Let revman.nvim sync PRs in the background so your review queue is always up to date.

And it also includes features like analytics and advanced filtering - handy extras to help you stay organized and productive!

Typical Workflow

Add your repo:
Use :RevmanAddRepo in your project directory to register the current repo.
Sync PRs:
Run :RevmanSyncAllPRs to fetch PRs from GitHub into a local SQLite database.
Browse & Filter:
Use Telescope-powered commands like :RevmanListOpenPRs or :RevmanListPRs to find and select PRs.
Review & Take Notes:
Open a PR for review with :RevmanReviewPR (opens in Octo.nvim if installed).
Add or edit notes with :RevmanAddNote.
Track Status:
Update PR review status with :RevmanSetStatus.
Stay Up to Date:
Enable background sync with :RevmanEnableBackgroundSync to keep your PR list fresh.

Installation

Requirements:

Neovim 0.7+
kkharji/sqlite.lua
GitHub CLI (gh) (must be installed and authenticated)
pwntester/octo.nvim (optional, but required for PR review UI and strongly suggested)

A Picker is strongly recommended. Supported pickers:

Example (Lazy.nvim):

{
  "3ZsForInsomnia/revman.nvim",
  dependencies = {
    "kkharji/sqlite.lua",
    "pwntester/octo.nvim",
  },
  config = true,
}

Setup

Call require("revman").setup() in your config.
Example:

require("revman").setup({
  database_path = vim.fn.stdpath("state") .. "/revman/revman.db",
  data_retention_days = 30, -- days to keep PRs (0 = keep forever)
  background_sync_frequency = 15, -- minutes between background syncs (0 = disable)
  
  -- Auto-assignment features
  auto_add_assigned_prs = "smart", -- "smart", "smart+manual", "manual", "off"
  remove_unassigned_prs = "smart", -- "smart", "always", "never"
  
  picker = "vimSelect", -- "vimSelect", "telescope", or "snacks"
  log_level = "warn", -- "info", "warn", or "error"
})

Main Commands

Command	Description
`:RevmanAddRepo`	Add current repo to tracking
`:RevmanSyncAllPRs`	Sync all PRs for the current repo
`:RevmanListPRs`	List all PRs (Telescope picker)
`:RevmanListOpenPRs`	List open PRs (Telescope picker)
`:RevmanListMergedPRs`	List merged PRs (Telescope picker)
`:RevmanReviewPR`	Mark PR as reviewed and open for review
`:RevmanSetStatus`	Set review status for a PR
`:RevmanAddNote`	Add or edit a note for a PR
`:RevmanShowNotes`	Browse PR notes (Telescope picker)
`:RevmanEnableBackgroundSync`	Enable background PR sync
`:RevmanDisableBackgroundSync`	Disable background PR sync
`:RevmanListAssignedPRs`	List PRs where you're assigned/requested
`:RevmanRepairDB`	Repair and upgrade database schema

For full details and advanced usage, see :help revman.

Auto-Assignment Features

RevMan.nvim can automatically track PRs where you're assigned or your review is requested, keeping your review queue up to date without manual intervention.

Configuration Options

auto_add_assigned_prs - Controls when PRs are automatically added to tracking:

"smart" (default): Automatically add PRs where you're assigned or review-requested
"smart+manual": Auto-add like smart mode, but also show :RevmanListAssignedPRs for manual selection
"manual": Only add PRs via :RevmanListAssignedPRs command (no auto-add)
"off": Disable auto-assignment features entirely

remove_unassigned_prs - Controls when PRs are automatically removed from tracking:

"smart" (default): Remove PRs when you're unassigned, but keep them if you've interacted (notes, comments, status changes, recent views)
"always": Always remove PRs when you're unassigned (ignores interaction)
"never": Never automatically remove PRs

How It Works

Assignment Detection: The plugin treats being assigned to a PR and having your review requested as equivalent
Smart Removal: In "smart" mode, PRs are only removed if you haven't:
- Added notes to the PR
- Commented on the PR
- Changed the PR's review status
Background Sync: Auto-assignment runs during background sync to keep your queue current
Manual Override: Use :RevmanListAssignedPRs to manually select from assigned/requested PRs

Example Workflows

For active reviewers (recommended):

auto_add_assigned_prs = "smart",
remove_unassigned_prs = "smart",

This automatically manages your review queue while protecting PRs you've interacted with.

For manual control:

auto_add_assigned_prs = "manual", 
remove_unassigned_prs = "never",

You manually select which assigned PRs to track, and they stay tracked until you remove them.

For comprehensive tracking:

auto_add_assigned_prs = "smart+manual",
remove_unassigned_prs = "smart",

Auto-adds assigned PRs but also provides :RevmanListAssignedPRs for additional manual selection.

Roadmap

Simplifying and documenting exposed API