A lightweight command-line tool that spins up a local web server to display Git commit diffs in a GitHub-like Files changed view. Perfect for code review workflows without leaving the terminal! 🚀
- ⚡ Zero Config: Just run
npx reviewit <commit>and it works - 🌙 Review for AI: Add comments and generate Claude Code prompts
- 🖥️ Terminal UI: View diffs directly in terminal with
--tui
npx reviewit # View HEAD commit changes in a beautiful diff viewernpx reviewit <commit-ish> # View single commit diff
npx reviewit <commit-ish> [compare-with] # Compare two commits/branches
npx reviewit --pr <github-pr-url> # Review GitHub pull requestnpx reviewit 6f4a9b7 # Specific commit
npx reviewit HEAD^ # Previous commit
npx reviewit feature # Latest commit on branchnpx reviewit HEAD main # Compare HEAD with main branch
npx reviewit feature main # Compare branches
npx reviewit . origin/main # Compare working directory with remote mainReviewIt supports special keywords for common diff scenarios:
npx reviewit # HEAD commit changes
npx reviewit . # All uncommitted changes (staged + unstaged)
npx reviewit staged # Staged changes ready for commit
npx reviewit working # Unstaged changes only (cannot use compare-with)| Keyword | Description | Compare-with Support |
|---|---|---|
. |
Shows all uncommitted changes (both staged & unstaged) | ✅ Yes |
staged |
Shows staged changes ready to be committed | ✅ Yes |
working |
Shows unstaged changes in your working directory | ❌ No |
npx reviewit --pr https://github.com/owner/repo/pull/123ReviewIt automatically handles GitHub authentication using:
- GitHub CLI (recommended): If you're logged in with
gh auth login, ReviewIt uses your existing credentials - Environment Variable: Set
GITHUB_TOKENenvironment variable - No Authentication: Public repositories work without authentication (rate-limited)
| Flag | Default | Description |
|---|---|---|
<commit-ish> |
HEAD | Any Git reference: hash, tag, HEAD~n, branch, or Special Arguments |
[compare-with] |
(optional) | Optional second commit to compare with (shows diff between the two) |
--pr <url> |
- | GitHub PR URL to review (e.g., https://github.com/owner/repo/pull/123) |
--port |
auto | Preferred port; falls back if occupied |
--no-open |
false | Don't automatically open browser |
--mode |
side-by-side | Diff mode: inline or side-by-side |
--tui |
false | Use terminal UI mode instead of web interface |
ReviewIt includes an inline commenting system that integrates with Claude Code:
- Add Comments: Click on any diff line to add a comment
- Edit Comments: Edit existing comments with the edit button
- Generate Prompts: Comments include a "Copy Prompt" button that formats the context for Claude Code
- Copy All: Use "Copy All Prompt" to copy all comments in a structured format
- Persistent Storage: Comments are saved in browser localStorage per commit
src/components/Button.tsx:42 # Automatically added this line
This name should probably be more specific.ReviewIt supports syntax highlighting for multiple programming languages with dynamic loading:
- JavaScript/TypeScript:
.js,.jsx,.ts,.tsx - Web Technologies: HTML, CSS, JSON, XML, Markdown
- Shell Scripts:
.sh,.bash,.zsh,.fishfiles - Backend Languages: PHP, SQL, Ruby, Java, Scala
- Systems Languages: C, C++, Rust, Go
- Others: Python, Swift, Kotlin, YAML
- Languages are loaded on-demand for better performance
- Automatic language detection from file extensions
- Fallback to plain text for unsupported languages
- Safe dependency resolution (e.g., PHP requires markup-templating)
# Install dependencies
pnpm install
# Start development server (with hot reload)
# This runs both Vite dev server and CLI with NODE_ENV=development
pnpm run dev
# Build and start production server
pnpm run start <commit-ish>
# Build for production
pnpm run build
# Run tests
pnpm test
# Lint and format
pnpm run lint
pnpm run format
pnpm run typecheckpnpm run dev: Starts both Vite dev server (with hot reload) and CLI server simultaneouslypnpm run start <commit-ish>: Builds everything and starts production server (for testing final build)- Development mode: Uses Vite's dev server for hot reload and fast development
- Production mode: Serves built static files (used by npx and production builds)
- CLI: Commander.js for argument parsing with comprehensive validation
- Backend: Express server with simple-git for diff processing
- GitHub Integration: Octokit for GitHub API with automatic authentication (GitHub CLI + env vars)
- Frontend: React 18 + TypeScript + Vite
- Styling: Tailwind CSS v4 with GitHub-like dark theme
- Syntax Highlighting: Prism.js with dynamic language loading
- Testing: Vitest for unit tests with co-located test files
- Quality: ESLint, Prettier, lefthook pre-commit hooks
- Node.js ≥ 21.0.0
- Git repository with commits to review
MIT 📝