prview

A terminal dashboard for your GitHub pull requests.

prview lets you monitor pull requests across all your GitHub repositories from a single TUI, powered by React and Ink.

Features

• View pull requests across multiple repositories in one place
• Two tabs: My PRs and Review PRs (review requested)
• Group PRs sharing a branch name across repositories (g)
• Real-time filtering and sorting
• Auto-refresh every 60 seconds
• Status badges (Approved, Changes Requested, Draft, etc.)
• Press Enter to open a PR in your browser

Prerequisites

GitHub CLI (gh) must be installed and authenticated:

gh auth login

Installation

npm install -g @dacsar/prview

Usage

pv

Keybindings

Navigation

| Key | Action | | --- | --- | | Tab | Switch between My PRs / Review PRs | | j / Down | Move selection down | | k / Up | Move selection up |

PR Actions

| Key | Action | | --- | --- | | Enter / l | Open selected PR in browser | | o | Mark draft as ready for review | | m | Merge approved PR (auto-updates if behind) | | y | Copy PR URL | | Y | Copy branch name |

Grouping

| Key | Action | | --- | --- | | g | Toggle grouping PRs by branch name across repositories | | l / Enter | Expand the group under the cursor | | h | Collapse the group under the cursor | | H / L | Collapse / Expand all groups |

Linear

| Key | Action | | --- | --- | | Space l g | Open the Linear issue for the selected branch | | Space l y | Copy the Linear issue URL | | Space l c | Copy the Linear issue ID |

Pressing Space shows a which-key style hint panel in the bottom-right corner. Space l g opens the Linear desktop app when installed, falling back to the browser otherwise. Works when the branch name contains a Linear issue identifier (e.g. username/eng-123-fix-login). The first time a team key (the ENG in ENG-123) is seen, you'll be asked for its Linear workspace slug (the part after linear.app/ in issue URLs); the mapping is saved to ~/.config/prview/state.json, so issues from multiple workspaces work side by side.

General

| Key | Action | | --- | --- | | / | Enter filter mode | | Esc | Exit filter mode / Clear filter | | r | Refresh | | ? | Toggle help | | q | Quit |

Tech Stack

• React + Ink — Terminal UI
• TypeScript
• esbuild — Bundler
• Biome — Linter & Formatter

Development

git clone https://github.com/your-username/prview.git
cd prview
make setup
npm run dev

ローカルで動作確認

ビルドして実行を一発で行えます:

make pv