reviw-plugin

Human-in-the-loop review interface for AI coding workflows

日本語

---

reviw

A lightweight browser-based tool for reviewing and annotating tabular data, text, Markdown, and diff files. Built entirely in MoonBit (zero hand-written JavaScript). Supports CSV, TSV, plain text, Markdown, and unified diff formats. Comments are output as YAML to stdout.

Features

File Format Support

• CSV/TSV: View tabular data with sticky headers, column freezing, filtering, and column resizing
• Markdown: Side-by-side preview with synchronized scrolling, click-to-comment from preview
• Diff/Patch: GitHub-style diff view with syntax highlighting, collapsible large files (500+ lines), and binary files sorted to end
• Text: Line-by-line commenting for plain text files

Mermaid.js Diagrams

• Auto-detect and render Mermaid diagrams in Markdown files
• Click any diagram to open fullscreen viewer with minimap
• Zoom with mouse wheel (centered on cursor position, up to 10x)
• Pan with mouse drag
• Trackpad pinch-to-zoom and touch gesture support
• Shift+scroll zoom for Windows users
• Dark mode support for thumbnails
• Highlights corresponding source line after closing fullscreen
• Syntax error display in toast notifications

Media Sidebar

• Thumbnail gallery of all images and videos in the left sidebar
• Click any thumbnail to scroll to the corresponding media and highlight the source line
• Numbered badges for quick identification

Media Fullscreen

• Click images in Markdown preview to open fullscreen viewer
• Click videos to open fullscreen playback with YouTube-like keyboard shortcuts (Space/K, J/L, arrow keys, 0-9)
• Click anywhere (including the image/video itself) to close the fullscreen overlay
• Clicking media automatically highlights the corresponding source line in the Markdown panel
• Video timeline settings with adjustable scene detection sensitivity

UI Features

• Theme toggle: Switch between light and dark modes
• Preview-only mode: Hide source panel for wide preview reading
• Heading toggle: Collapse/expand sections by clicking heading arrows
• Multi-file support: Open multiple files simultaneously on separate ports
• Drag selection: Select rectangular regions or multiple rows for batch comments
• Real-time updates: Hot reload on file changes via SSE
• Comment persistence: Auto-save comments to localStorage with recovery modal
• Image attachment: Attach images to comments and submit dialog (paste with Cmd/Ctrl+V)
• Selected-lines copy: Copy button in comment dialog to copy selected line text
• Keyboard shortcuts: Cmd/Ctrl+Enter to open submit modal
• Multi-tab sync: Submit from any tab closes all tabs for the same file
• Server detection: Reuse existing server instead of starting a new one (via lock files)
• Tab activation (macOS): Automatically activates existing browser tab via AppleScript
• Review history: File-based persistent review history
• details/summary support: HTML details/summary tags rendered as collapsible sections

Output

• YAML format with file, mode, row, col, value, and comment text
• Overall summary field for review notes
• Image attachments included as base64 data

Installation

npm install -g reviw

Or run directly with npx:

npx reviw <file>

Usage

# Single file
reviw <file> [--port 4989] [--encoding utf8|shift_jis|...]

# Multiple files (each opens on consecutive ports)
reviw file1.csv file2.md file3.tsv --port 4989

# Diff from stdin
git diff HEAD | reviw

# Diff file
reviw changes.diff

Options

• --port <number>: Specify starting port (default: 4989)
• --encoding <encoding>: Force specific encoding (auto-detected by default)
• --no-open: Prevent automatic browser opening
• --help, -h: Show help message
• --version, -v: Show version number

Workflow

1. Browser opens automatically (macOS: open / Linux: xdg-open / Windows: start)
2. Click cells/lines to add comments, or drag to select multiple
3. Use Cmd/Ctrl+Enter or click "Submit & Exit" to output comments
4. Comments are printed as YAML to stdout

Screenshots

Markdown View with Media Sidebar