Better Code Review

English | 简体中文

Better Code Review is a local snapshot-backed review UI for inspecting AI-generated code changes. It is designed for developers who use tools such as Claude Code CLI, Codex CLI, Cursor, or VS Code Copilot and want a simple review screen before accepting or rolling back changed files.

Run review inside a project folder before making AI edits. The command starts a local web server on port 1024, captures a one-run in-memory snapshot of the current files, and opens a browser UI that shows changes made after the server starts.

Features

• Local-only review server at http://127.0.0.1:1024
• No Git commands, no staging area changes, and no hidden review state written to the project
• One-run in-memory baseline captured at startup
• Large binary files over 5 MB are tracked by name and metadata only, not copied into memory
• Side-by-side diff for changed text files
• Per-file Save and Rollback actions
• Bulk Save all and Rollback all actions
• No runtime dependencies beyond Python and the Python standard library

Installation

Requirements:

• Python 3.10+

Recommended install from GitHub:

pipx install git+https://github.com/vexpaer/better_code_review.git

If you do not use pipx, install with pip:

pip install git+https://github.com/vexpaer/better_code_review.git

For local development:

git clone https://github.com/vexpaer/better_code_review.git
cd better_code_review
pip install -e .

Usage

Open a terminal in the project you want to review:

review

Then open:

http://127.0.0.1:1024

Common options:

review --port 1025
review --repo /path/to/project
review --no-browser

Workflow

1. Run review in your project.
2. Run an AI coding tool while the review server is still open.
3. Inspect each changed file in the browser.
4. Click Save to mark accepted files or blocks in the current review session.
5. Click Rollback to restore unwanted files or blocks to the session snapshot.
6. Close the review server when done. Closing the server forgets the temporary snapshot, so the current files on disk are treated as saved on the next run.

Each review run starts from zero with a fresh in-memory snapshot. It does not remember accepted or rejected files from previous runs.

Notes

• Save does not create a commit or run git add. It only updates the current review session's accepted snapshot.
• Rollback is destructive for the selected file.
• The server is intended for local use. Keep the default 127.0.0.1 host unless you understand the security implications.

Development

Run the test suite:

python -m unittest discover -s tests -p "test_*.py" -v