Skip to content

sleuth-io/prx

Repository files navigation

prx

Smart code review for humans


Downloads PRs Welcome

What is prx?

prx is a code review terminal that helps you focus. AI scores each PR, collapses the noise, and surfaces what actually needs your attention. Review faster and smarter, even after merge.

  • Risk scoring - each PR is scored across configurable criteria (blast radius, intent clarity, irreversibility, domain knowledge, novelty) and given a verdict: APPROVE, REVIEW, or INVESTIGATE
  • Chat-first interface - the primary interface is a conversation. Ask questions, take PR actions, tune scoring criteria — all through chat
  • Smart diff viewer - full-screen diff with per-hunk risk annotations and key hunk preview. Trivial hunks auto-collapse so you see only what needs your brain
  • Incremental review - prx tracks what you've seen. On return visits, only new or changed code and comments are expanded. Rebases that don't change code are invisible
  • Bulk approve - clear a queue of low-risk PRs in one pass before focusing on the ones that need real attention
  • Post-merge review - catch merged PRs that landed without your approval, flag or approve with reactions

Install

Quick install (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/sleuth-io/prx/main/install.sh | bash

Or download the latest binary from Releases.

From source:

git clone https://github.com/sleuth-io/prx.git
cd prx
make install

Prerequisites

Usage

# Run in the current repo
prx

# Run against a different repo
prx /path/to/repo

For the full reference — shortcuts, slash commands, scoring, configuration, post-merge review, custom skills, and more — see the User Guide. The guide is also available in-app: type /user-guide in chat or ask "how do I configure scoring?"

License

See LICENSE file for details.


Development

Building from Source

make init           # Download dependencies
make build          # Build binary
make install        # Install to ~/.local/bin

Testing

make test           # Run tests
make lint           # Run linter
make prepush        # Format, lint, test, build

Releases

Tag and push to trigger automated release via GoReleaser:

git tag v0.1.0
git push origin v0.1.0

Demo GIF

Requires vhs:

make demo

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages