https://github.com/joeyism/gh-pr-status
Displays CI status, review decisions, merge readiness, and comment/thread counts in a single view
https://github.com/joeyism/gh-pr-status
cli gh pr pull requests status tui
Last synced: about 13 hours ago
JSON representation
Displays CI status, review decisions, merge readiness, and comment/thread counts in a single view
- Host: GitHub
- URL: https://github.com/joeyism/gh-pr-status
- Owner: joeyism
- License: apache-2.0
- Created: 2026-03-21T03:10:00.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T00:53:40.000Z (about 1 month ago)
- Last Synced: 2026-04-24T02:31:35.805Z (about 1 month ago)
- Topics: cli, gh, pr, pull, requests, status, tui
- Language: Go
- Homepage:
- Size: 6.72 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gh-pr-status
A `gh` extension that shows a live terminal dashboard of your open pull requests across GitHub organizations.
Displays CI status, review decisions, merge readiness, and comment/thread counts in a single view. Polls GitHub automatically and highlights PRs that change state.
## Installation
```bash
gh extension install joeyism/gh-pr-status
```
## Usage
```bash
gh pr-status
```
By default it shows all open PRs authored by you. To scope results to specific organizations, create a config file (see Configuration).
### Flags
| Flag | Description |
|---|---|
| `--config ` | Path to config file (default: `~/.config/gh-prs/config.yaml`) |
### Keybindings
| Key | Action |
|---|---|
| `j` / `k` or arrow keys | Move cursor up/down |
| `tab` | Expand/collapse check runs for selected PR |
| `o` | Open selected PR in browser |
| `r` | Force refresh |
| `c` | Post `@cursor review` comment on selected PR |
| `q` / `ctrl+c` | Quit |
## Configuration
Create `~/.config/gh-prs/config.yaml`:
```yaml
orgs:
- mycompany
- other-org
poll_interval: "30s"
```
| Field | Description | Default |
|---|---|---|
| `orgs` | GitHub organizations to include in the PR search | none |
| `poll_interval` | How often to refresh (minimum `5s`) | `30s` |
## Authentication
The extension uses your existing `gh` credentials. Run `gh auth login` if you have not already authenticated. You can also set `GITHUB_TOKEN` or `GH_TOKEN` as an environment variable to override.
## Requirements
- `gh` CLI installed and authenticated
- Go 1.21 or later (only needed if building from source)
## Building from source
```bash
git clone https://github.com/joeyism/gh-pr-status
cd gh-pr-status
go build -o gh-pr-status .
```