difit 0.0.1

package/README.md

@@ -0,0 +1,106 @@
+# ReviewIt 🔍
+
+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! 🚀
+
+## ✨ Features
+
+- 🌙 **GitHub-like UI**: Familiar dark theme file list and diff interface
+- 💬 **Inline Comments**: Add comments to specific lines and generate Claude Code prompts
+- 🔄 **Side-by-Side & Inline Views**: Choose your preferred diff viewing mode
+- ⚡ **Zero Config**: Just run `npx reviewit <commit>` and it works
+- 🔐 **Local Only**: Never exposes data over network - runs on localhost only
+- 🛠️ **Modern Stack**: React 18 + TypeScript + Tailwind CSS
+
+## 📦 Installation
+
+```bash
+# Global install
+npm install -g reviewit
+
+# Or use npx (no installation needed) 
+npx reviewit <commit-ish>
+```
+
+## 🚀 Usage
+
+```bash
+# Review a specific commit
+reviewit 6f4a9b7
+
+# Review HEAD~3
+reviewit HEAD~3
+
+# Custom port, don't auto-open browser  
+reviewit 6f4a9b7 --port 4300 --no-open
+
+# Via npx
+npx reviewit main~1
+```
+
+### ⚙️ CLI Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `<commit-ish>` | (required) | Any Git reference: hash, tag, HEAD~n, branch |
+| `--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` |
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Start development server
+pnpm run dev
+
+# Build for production
+pnpm run build
+
+# Run tests
+pnpm test
+
+# Lint and format
+pnpm run lint
+pnpm run format
+pnpm run typecheck
+```
+
+## 💬 Comment System
+
+ReviewIt includes an inline commenting system that integrates with Claude Code:
+
+1.️ **Add Comments**: Click the 💬 icon on any diff line to add a comment
+2. **Generate Prompts**: Comments include a "Copy Prompt" button that formats the context for Claude Code
+3. **Persistent Storage**: Comments are saved in `.reviewit/tmp-comments-*.json` for the session
+
+### Comment Prompt Format
+
+```
+📄 src/components/Button.tsx L42
+----
++ const handleClick = () => {
++   onClick();  
++ };
+----
+Comment: "This function name could be more specific"
+```
+
+## 🏗️ Architecture
+
+- **CLI**: Commander.js for argument parsing
+- **Backend**: Express server with simple-git for diff processing  
+- **Frontend**: React 18 + TypeScript + Vite
+- **Styling**: Tailwind CSS v4 with GitHub-like dark theme
+- **Testing**: Vitest for unit tests
+- **Quality**: ESLint, Prettier, lefthook pre-commit hooks
+
+## 📋 Requirements
+
+- Node.js ≥ 18.0.0
+- Git repository with commits to review
+
+## 📄 License
+
+MIT 📝

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { startServer } from '../server/server.js';
+import { validateCommitish } from './utils.js';
+const program = new Command();
+program
+    .name('reviewit')
+    .description('A lightweight Git diff viewer with GitHub-like interface')
+    .version('0.1.0')
+    .argument('<commit-ish>', 'Git commit, tag, branch, or HEAD~n reference')
+    .option('--port <port>', 'preferred port (auto-assigned if occupied)', parseInt)
+    .option('--no-open', 'do not automatically open browser')
+    .option('--mode <mode>', 'diff mode (inline only for now)', 'inline')
+    .action(async (commitish, options) => {
+    try {
+        if (!validateCommitish(commitish)) {
+            console.error('Error: Invalid commit-ish format');
+            process.exit(1);
+        }
+        const { url } = await startServer({
+            commitish,
+            preferredPort: options.port,
+            openBrowser: options.open,
+            mode: options.mode,
+        });
+        console.log(`\n🚀 ReviewIt server started on ${url}`);
+        console.log(`📋 Reviewing: ${commitish}`);
+        if (options.open) {
+            console.log('🌐 Opening browser...\n');
+        }
+        else {
+            console.log('💡 Use --open to automatically open browser\n');
+        }
+        process.on('SIGINT', () => {
+            console.log('\n👋 Shutting down ReviewIt server...');
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : 'Unknown error');
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/cli/index.test.d.ts

@@ -0,0 +1 @@
+export {};