critique 0.1.40 → 0.1.42

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+# 0.1.42
+
+- New `--image` flag for all diff commands:
+  - Generates WebP images of terminal output (saved to /tmp)
+  - Splits long diffs into multiple images (70 lines per image)
+  - Uses takumi for high-performance image rendering
+  - `@takumi-rs/core` and `@takumi-rs/helpers` added as optional dependencies
+  - Library export: `import { renderTerminalToImages } from "critique/src/image.ts"`
+- Web output: Use default theme to enable dark/light mode switching based on system preference
+- `review` command:
+  - Improved AI prompt: order hunks by code flow, think upfront before writing, split heavy logic across sections
+- Dependencies:
+  - Update opentui to `367a9408`
+
+# 0.1.41
+
+- `review` command:
+  - Filter `--resume` reviews by current working directory (only shows reviews from cwd or subdirectories)
+  - Use ACP `unstable_listSessions` for OpenCode instead of parsing JSON files directly
+  - Falls back to file-based parsing for Claude Code when ACP method unavailable
+  - Add instruction to always close code blocks before new text (fixes unclosed diagram blocks)
+
 # 0.1.40
 
 - `review` command:

package/bun.lock

@@ -7,8 +7,8 @@
       "dependencies": {
         "@agentclientprotocol/sdk": "^0.12.0",
         "@clack/prompts": "1.0.0-alpha.9",
-        "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@302acd5f2860aaeecf5a1a60325c195e3a0597e4",
-        "@opentui/react": "https://pkg.pr.new/anomalyco/opentui/@opentui/react@302acd5f2860aaeecf5a1a60325c195e3a0597e4",
+        "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@367a94087821b3b5feedd35bbb57df43b10a286e",
+        "@opentui/react": "https://pkg.pr.new/anomalyco/opentui/@opentui/react@367a94087821b3b5feedd35bbb57df43b10a286e",
         "@parcel/watcher": "^2.5.1",
         "bun-pty": "^0.4.7",
         "cac": "^6.7.14",
@@ -27,6 +27,10 @@
         "typescript": "^5.9.3",
         "wrangler": "^4.19.1",
       },
+      "optionalDependencies": {
+        "@takumi-rs/core": "^0.65.0",
+        "@takumi-rs/helpers": "^0.65.0",
+      },
     },
   },
   "packages": {
@@ -222,21 +226,21 @@
 
     "@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.9", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.0.3", "@jridgewell/sourcemap-codec": "^1.4.10" } }, "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ=="],
 
-    "@opentui/core": ["@opentui/core@https://pkg.pr.new/anomalyco/opentui/@opentui/core@302acd5f2860aaeecf5a1a60325c195e3a0597e4", { "dependencies": { "bun-ffi-structs": "0.1.2", "diff": "8.0.2", "jimp": "1.6.0", "marked": "17.0.1", "yoga-layout": "3.2.1" }, "optionalDependencies": { "@dimforge/rapier2d-simd-compat": "^0.17.3", "@opentui/core-darwin-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "@opentui/core-darwin-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "@opentui/core-linux-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "@opentui/core-linux-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "@opentui/core-win32-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "@opentui/core-win32-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "bun-webgpu": "0.1.4", "planck": "^1.4.2", "three": "0.177.0" }, "peerDependencies": { "web-tree-sitter": "0.25.10" } }],
+    "@opentui/core": ["@opentui/core@https://pkg.pr.new/anomalyco/opentui/@opentui/core@367a94087821b3b5feedd35bbb57df43b10a286e", { "dependencies": { "bun-ffi-structs": "0.1.2", "diff": "8.0.2", "jimp": "1.6.0", "marked": "17.0.1", "yoga-layout": "3.2.1" }, "optionalDependencies": { "@dimforge/rapier2d-simd-compat": "^0.17.3", "@opentui/core-darwin-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", "@opentui/core-darwin-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-x64@367a94087821b3b5feedd35bbb57df43b10a286e", "@opentui/core-linux-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", "@opentui/core-linux-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-x64@367a94087821b3b5feedd35bbb57df43b10a286e", "@opentui/core-win32-arm64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", "@opentui/core-win32-x64": "https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-x64@367a94087821b3b5feedd35bbb57df43b10a286e", "bun-webgpu": "0.1.4", "planck": "^1.4.2", "three": "0.177.0" }, "peerDependencies": { "web-tree-sitter": "0.25.10" } }],
 
-    "@opentui/core-darwin-arm64": ["@opentui/core-darwin-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-darwin-arm64": ["@opentui/core-darwin-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/core-darwin-x64": ["@opentui/core-darwin-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-darwin-x64": ["@opentui/core-darwin-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-darwin-x64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/core-linux-arm64": ["@opentui/core-linux-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-linux-arm64": ["@opentui/core-linux-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/core-linux-x64": ["@opentui/core-linux-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-linux-x64": ["@opentui/core-linux-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-linux-x64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/core-win32-arm64": ["@opentui/core-win32-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-arm64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-win32-arm64": ["@opentui/core-win32-arm64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-arm64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/core-win32-x64": ["@opentui/core-win32-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-x64@302acd5f2860aaeecf5a1a60325c195e3a0597e4", {}],
+    "@opentui/core-win32-x64": ["@opentui/core-win32-x64@https://pkg.pr.new/anomalyco/opentui/@opentui/core-win32-x64@367a94087821b3b5feedd35bbb57df43b10a286e", {}],
 
-    "@opentui/react": ["@opentui/react@https://pkg.pr.new/anomalyco/opentui/@opentui/react@302acd5f2860aaeecf5a1a60325c195e3a0597e4", { "dependencies": { "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@302acd5f2860aaeecf5a1a60325c195e3a0597e4", "react-reconciler": "^0.32.0" }, "peerDependencies": { "react": ">=19.0.0", "react-devtools-core": "^7.0.1", "ws": "^8.18.0" } }],
+    "@opentui/react": ["@opentui/react@https://pkg.pr.new/anomalyco/opentui/@opentui/react@367a94087821b3b5feedd35bbb57df43b10a286e", { "dependencies": { "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@367a94087821b3b5feedd35bbb57df43b10a286e", "react-reconciler": "^0.32.0" }, "peerDependencies": { "react": ">=19.0.0", "react-devtools-core": "^7.0.1", "ws": "^8.18.0" } }],
 
     "@parcel/watcher": ["@parcel/watcher@2.5.4", "", { "dependencies": { "detect-libc": "^2.0.3", "is-glob": "^4.0.3", "node-addon-api": "^7.0.0", "picomatch": "^4.0.3" }, "optionalDependencies": { "@parcel/watcher-android-arm64": "2.5.4", "@parcel/watcher-darwin-arm64": "2.5.4", "@parcel/watcher-darwin-x64": "2.5.4", "@parcel/watcher-freebsd-x64": "2.5.4", "@parcel/watcher-linux-arm-glibc": "2.5.4", "@parcel/watcher-linux-arm-musl": "2.5.4", "@parcel/watcher-linux-arm64-glibc": "2.5.4", "@parcel/watcher-linux-arm64-musl": "2.5.4", "@parcel/watcher-linux-x64-glibc": "2.5.4", "@parcel/watcher-linux-x64-musl": "2.5.4", "@parcel/watcher-win32-arm64": "2.5.4", "@parcel/watcher-win32-ia32": "2.5.4", "@parcel/watcher-win32-x64": "2.5.4" } }, "sha512-WYa2tUVV5HiArWPB3ydlOc4R2ivq0IDrlqhMi3l7mVsFEXNcTfxYFPIHXHXIh/ca/y/V5N4E1zecyxdIBjYnkQ=="],
 
@@ -276,6 +280,26 @@
 
     "@speed-highlight/core": ["@speed-highlight/core@1.2.14", "", {}, "sha512-G4ewlBNhUtlLvrJTb88d2mdy2KRijzs4UhnlrOSRT4bmjh/IqNElZa3zkrZ+TC47TwtlDWzVLFADljF1Ijp5hA=="],
 
+    "@takumi-rs/core": ["@takumi-rs/core@0.65.0", "", { "optionalDependencies": { "@takumi-rs/core-darwin-arm64": "0.65.0", "@takumi-rs/core-darwin-x64": "0.65.0", "@takumi-rs/core-linux-arm64-gnu": "0.65.0", "@takumi-rs/core-linux-arm64-musl": "0.65.0", "@takumi-rs/core-linux-x64-gnu": "0.65.0", "@takumi-rs/core-linux-x64-musl": "0.65.0", "@takumi-rs/core-win32-arm64-msvc": "0.65.0", "@takumi-rs/core-win32-x64-msvc": "0.65.0" } }, "sha512-lBNG+NRc602ul7Kxy9UohlbnFLVyloQP/DTxQzyNH+8khpdaIQTxpdHouzRzxf6upRDVDIVX5TG8oT16jKUAvQ=="],
+
+    "@takumi-rs/core-darwin-arm64": ["@takumi-rs/core-darwin-arm64@0.65.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-Ii6ILOANG6IeGThsuYjG5azlHXyHWWdVbM1ps3+SJyUg2g4Qn+nTruKGqHQOLNdZ5+37vpTg4PWh79XrUvjXpw=="],
+
+    "@takumi-rs/core-darwin-x64": ["@takumi-rs/core-darwin-x64@0.65.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-SJGeFVQ2foVHpYL6EiD+jNJnvQmegDLbbJ/SzbaYemJ/kjza2vNDg251urXne6daQ+HoGXLjhQtzW1C5Nyyf5g=="],
+
+    "@takumi-rs/core-linux-arm64-gnu": ["@takumi-rs/core-linux-arm64-gnu@0.65.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-YbwZzQTugFwvYErXs2W/QsngPSU5H6ZtYJNdbz9/qk8EEU6eB593XiBxE9/1vbq6Sb3mH84mPXElf1BmWJlvzw=="],
+
+    "@takumi-rs/core-linux-arm64-musl": ["@takumi-rs/core-linux-arm64-musl@0.65.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-iZpzfnD1/Gyof3p+fYUIBxNkDH9vQviOeihZ7yAtPbGmY4AbnOjoUBHDyJoKWE0el/x1W17efvNE7FuvzP0O5Q=="],
+
+    "@takumi-rs/core-linux-x64-gnu": ["@takumi-rs/core-linux-x64-gnu@0.65.0", "", { "os": "linux", "cpu": "x64" }, "sha512-kL4VclPYz7nmQuadCVSrAFvdy8LaJX5RPymG3upaHPcz0i7A8KmWY8jnQcDDkGQfPIi2lFncnt/sknCiaJ1t4Q=="],
+
+    "@takumi-rs/core-linux-x64-musl": ["@takumi-rs/core-linux-x64-musl@0.65.0", "", { "os": "linux", "cpu": "x64" }, "sha512-2way2sF3p5bMlhGsDMmQGTPxtc37241POzAJ0bPRKR1fumylEAaADuXvN95qM4x9751iTke/wVhJOL28nV7asw=="],
+
+    "@takumi-rs/core-win32-arm64-msvc": ["@takumi-rs/core-win32-arm64-msvc@0.65.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-yCZqiu1b3XXhDUE7OaA5RdVg/nYcZU1nzToY7ViE4fR8PqOK54Ad8qOAKYZCTr4FwCB4sWo88/R7K1n0nPFpfA=="],
+
+    "@takumi-rs/core-win32-x64-msvc": ["@takumi-rs/core-win32-x64-msvc@0.65.0", "", { "os": "win32", "cpu": "x64" }, "sha512-SAw224AhLcKa9+ttO4IxeTquOvyz8pnDeGugzmQZerYO18kOuOCiP1g4VRhM1drpEFN7bbnhSnIvrewg5m4akw=="],
+
+    "@takumi-rs/helpers": ["@takumi-rs/helpers@0.65.0", "", {}, "sha512-3BsiW0iP3Y7xUPmT/tJBClb59qTxtHEYHQUznXdtDA0qyN6YAWABA6U0DTd3la6XHMEDyKaHV263OL679FyPaA=="],
+
     "@tokenizer/token": ["@tokenizer/token@0.3.0", "", {}, "sha512-OvjF+z51L3ov0OyAU0duzsYuvO01PH7x4t6DJx+guahgTnBHkhJdG7soQeTSFLWN3efnHyibZ4Z8l2EuWwJN3A=="],
 
     "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],

package/package.json

@@ -2,7 +2,7 @@
   "name": "critique",
   "module": "src/diff.tsx",
   "type": "module",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "private": false,
   "bin": "./src/cli.tsx",
   "scripts": {
@@ -24,8 +24,8 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.12.0",
     "@clack/prompts": "1.0.0-alpha.9",
-    "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@302acd5f2860aaeecf5a1a60325c195e3a0597e4",
-    "@opentui/react": "https://pkg.pr.new/anomalyco/opentui/@opentui/react@302acd5f2860aaeecf5a1a60325c195e3a0597e4",
+    "@opentui/core": "https://pkg.pr.new/anomalyco/opentui/@opentui/core@367a94087821b3b5feedd35bbb57df43b10a286e",
+    "@opentui/react": "https://pkg.pr.new/anomalyco/opentui/@opentui/react@367a94087821b3b5feedd35bbb57df43b10a286e",
     "@parcel/watcher": "^2.5.1",
     "bun-pty": "^0.4.7",
     "cac": "^6.7.14",
@@ -35,5 +35,9 @@
     "picocolors": "^1.1.1",
     "react": "^19.2.0",
     "zustand": "^5.0.8"
+  },
+  "optionalDependencies": {
+    "@takumi-rs/core": "^0.65.0",
+    "@takumi-rs/helpers": "^0.65.0"
   }
 }

package/scripts/preview-review.tsx

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
-// Preview script for ReviewApp component
-// Run with: bun run scripts/preview-review.tsx
-// Web mode: bun run scripts/preview-review.tsx --web
+// Development preview script for testing ReviewApp styles without running AI.
+// Renders example hunks and review data to preview TUI appearance.
+// Run with: bun run scripts/preview-review.tsx (TUI) or --web (HTML upload).
 
 import { createCliRenderer } from "@opentui/core"
 import { createRoot } from "@opentui/react"

package/src/ansi-html.ts

@@ -1,3 +1,7 @@
+// ANSI terminal output to HTML converter for web preview generation.
+// Uses ghostty-opentui to parse PTY output and generates responsive HTML documents
+// with proper font scaling to fit terminal content within viewport width.
+
 import { ptyToJson, StyleFlags, type TerminalData, type TerminalLine, type TerminalSpan } from "ghostty-opentui"
 
 export interface AnsiToHtmlOptions {

package/src/cli.tsx

@@ -1,4 +1,8 @@
 #!/usr/bin/env bun
+// CLI entrypoint for the critique diff viewer.
+// Provides TUI diff viewing, AI-powered review generation, and web preview upload.
+// Commands: default (diff), review (AI analysis), web (HTML upload), pick (cherry-pick files).
+
 import { cac } from "cac";
 import {
   createRoot,
@@ -500,7 +504,8 @@ async function runReviewMode(
 
       // Write hunks to temp file for the render command
       const hunksFile = writeTempFile(JSON.stringify(hunks), "critique-hunks", ".json");
-      const themeName = persistedState.themeName ?? defaultThemeName;
+      // For web, always use default theme (with auto dark/light inversion) unless explicitly overridden
+      const themeName = defaultThemeName;
 
       // Calculate rows needed based on hunks
       const totalLines = hunks.reduce((sum, h) => sum + h.lines.length, 0);
@@ -667,12 +672,12 @@ async function runResumeMode(options: ResumeModeOptions) {
 
   let reviewId = options.reviewId;
 
-  // If no ID provided, show select
+  // If no ID provided, show select (filtered to current cwd and children)
   if (!reviewId) {
-    const reviews = listReviews();
+    const reviews = listReviews(process.cwd());
 
     if (reviews.length === 0) {
-      clack.log.warn("No saved reviews found");
+      clack.log.warn("No saved reviews found for this directory");
       clack.outro("");
       process.exit(0);
     }
@@ -830,7 +835,8 @@ async function runResumeMode(options: ResumeModeOptions) {
       }).join("\n");
     const yamlFile = writeTempFile(yamlContent, "critique-review", ".yaml");
 
-    const themeName = persistedState.themeName ?? defaultThemeName;
+    // For web, always use default theme (with auto dark/light inversion) unless explicitly overridden
+    const themeName = defaultThemeName;
     const totalLines = review.hunks.reduce((sum, h) => sum + h.lines.length, 0);
     const baseRows = Math.max(200, totalLines * 2 + 100);
 
@@ -914,6 +920,16 @@ interface WebModeOptions {
   '--'?: string[];
 }
 
+// Image mode handler
+interface ImageModeOptions {
+  staged?: boolean;
+  commit?: string;
+  context?: string;
+  filter?: string;
+  theme?: string;
+  '--'?: string[];
+}
+
 async function runWebMode(
   base: string | undefined,
   head: string | undefined,
@@ -939,9 +955,10 @@ async function runWebMode(
 
   const desktopCols = options.cols || 230;
   const mobileCols = options.mobileCols || 100;
+  // For web, always use default theme (with auto dark/light inversion) unless explicitly overridden via --theme
   const themeName = options.theme && themeNames.includes(options.theme)
     ? options.theme
-    : persistedState.themeName ?? defaultThemeName;
+    : defaultThemeName;
 
   console.log("Capturing diff output...");
 
@@ -1005,6 +1022,118 @@ async function runWebMode(
   }
 }
 
+async function runImageMode(
+  base: string | undefined,
+  head: string | undefined,
+  options: ImageModeOptions
+) {
+  const { renderTerminalToImages } = await import("./image.ts");
+  const { writeTempFile, cleanupTempFile } = await import("./web-utils.ts");
+
+  const gitCommand = buildGitCommand({
+    staged: options.staged,
+    commit: options.commit,
+    base,
+    head,
+    context: options.context,
+    filter: options.filter,
+    positionalFilters: options['--'],
+  });
+
+  const themeName = options.theme && themeNames.includes(options.theme)
+    ? options.theme
+    : persistedState.themeName ?? defaultThemeName;
+
+  console.log("Capturing diff output...");
+
+  // Get the git diff
+  const { stdout: gitDiff } = await execAsync(gitCommand, {
+    encoding: "utf-8",
+  });
+
+  if (!gitDiff.trim()) {
+    console.log("No changes to display");
+    process.exit(0);
+  }
+
+  // Write diff to temp file
+  const diffFile = writeTempFile(gitDiff, "critique-image-diff", ".patch");
+
+  // Build render command for image capture
+  const renderCommand = [
+    process.argv[1]!, // path to cli.tsx
+    "web-render",
+    diffFile,
+    "--theme",
+    themeName,
+    "--cols",
+    "120",
+    "--rows",
+    "10000",
+  ];
+
+  console.log("Rendering to images...");
+
+  try {
+    // Capture PTY output
+    const decoder = new TextDecoder();
+    let ansiOutput = "";
+    const cols = 120;
+    const rows = 10000;
+
+    const proc = Bun.spawn(["bun", ...renderCommand], {
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        TERM: "xterm-256color",
+      },
+      terminal: {
+        cols,
+        rows,
+        data(terminal, data) {
+          ansiOutput += decoder.decode(data, { stream: true });
+        },
+      },
+    });
+
+    await proc.exited;
+    proc.terminal?.close();
+    ansiOutput += decoder.decode();
+
+    // Clean up diff temp file
+    cleanupTempFile(diffFile);
+
+    if (!ansiOutput.trim()) {
+      console.error("No output captured");
+      process.exit(1);
+    }
+
+    // Strip terminal cleanup sequences
+    const clearIdx = ansiOutput.lastIndexOf("\x1b[H\x1b[J");
+    if (clearIdx > 0) {
+      ansiOutput = ansiOutput.slice(0, clearIdx);
+    }
+
+    // Render to images
+    const result = await renderTerminalToImages(ansiOutput, {
+      cols,
+      themeName,
+    });
+
+    console.log(`\nGenerated ${result.imageCount} image${result.imageCount === 1 ? "" : "s"}:`);
+    for (const path of result.paths) {
+      console.log(`  ${path}`);
+    }
+
+    process.exit(0);
+  } catch (error: unknown) {
+    cleanupTempFile(diffFile);
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("Failed to generate images:", message);
+    process.exit(1);
+  }
+}
+
 // Error boundary component
 interface ErrorBoundaryProps {
   children: React.ReactNode;
@@ -1350,6 +1479,7 @@ cli
   .option("--filter <pattern>", "Filter files by glob pattern (can be used multiple times)")
   .option("--theme <name>", "Theme to use for rendering")
   .option("--web [title]", "Generate web preview instead of TUI")
+  .option("--image", "Generate images instead of TUI (saved to /tmp)")
   .option("--open", "Open in browser (with --web)")
   .option("--cols <cols>", "Desktop columns for web render", { default: 240 })
   .option("--mobile-cols <cols>", "Mobile columns for web render", { default: 100 })
@@ -1407,6 +1537,19 @@ cli
       return;
     }
 
+    // If --image flag, delegate to image generation logic
+    if (options.image) {
+      await runImageMode(base, head, {
+        staged: options.staged,
+        commit: options.commit,
+        context: options.context,
+        filter: options.filter,
+        theme: options.theme,
+        '--': options['--'],
+      });
+      return;
+    }
+
     try {
       const gitCommand = buildGitCommand({
         staged: options.staged,

package/src/components/diff-view.tsx

@@ -1,4 +1,6 @@
-// Shared DiffView component for rendering git diffs with syntax highlighting
+// Shared DiffView component for rendering git diffs with syntax highlighting.
+// Wraps opentui's <diff> element with theme-aware colors and syntax styles.
+// Supports split and unified view modes with line numbers.
 
 import * as React from "react"
 import { SyntaxStyle } from "@opentui/core"

package/src/components/index.ts

@@ -1,2 +1,4 @@
-// Shared components
+// Shared React components for the TUI interface.
+// Exports reusable components used across main diff view and review mode.
+
 export { DiffView, type DiffViewProps } from "./diff-view.tsx"

package/src/diff-utils.ts

@@ -1,4 +1,6 @@
-// Shared utilities for diff processing between CLI commands
+// Shared utilities for git diff processing across CLI commands.
+// Builds git commands, parses diff files, detects filetypes for syntax highlighting,
+// and provides helpers for unified/split view mode selection.
 
 export const IGNORED_FILES = [
   "pnpm-lock.yaml",

package/src/dropdown.tsx

@@ -1,3 +1,7 @@
+// Searchable dropdown component for file and theme selection in TUI.
+// Supports keyboard navigation, fuzzy search filtering, and mouse interaction.
+// Used by main diff view for file picker and theme picker overlays.
+
 import React, { useState, useEffect, useRef, useCallback, type ReactNode } from "react";
 import { useKeyboard } from "@opentui/react";
 import { TextAttributes, TextareaRenderable } from "@opentui/core";