Skip to content
diffle

CLI Reference

diffle reviews whichever git repo you run it from. Each command prints a http://localhost:<port> URL and opens it in your browser — the diff renders there, not in the terminal.

Commands

Section titled “Commands”

diffle

Section titled “diffle”

Review the working tree against HEAD, including untracked files.

Terminal window
diffle

diffle staged

Section titled “diffle staged”

Review staged changes only.

Terminal window
diffle staged

diffle <branch>

Section titled “diffle <branch>”

Review the current branch against the named branch, using a PR-style three-dot comparison.

Terminal window
diffle main

diffle <ref1>..<ref2>

Section titled “diffle <ref1>..<ref2>”

Review a commit range.

Terminal window
diffle v0.1.0..HEAD

diffle browse [path]

Section titled “diffle browse [path]”

Review the whole codebase, optionally scoped to a path.

Terminal window
diffle browse
diffle browse src/server

diffle mcp serve

Section titled “diffle mcp serve”

Run the local MCP server for agent integrations. See MCP tools.

Terminal window
diffle mcp serve

diffle hook stop --agent <codex|claude-code>

Section titled “diffle hook stop --agent <codex|claude-code>”

Completion-hook entry used by the agent integrations.

Terminal window
diffle hook stop --agent codex
diffle hook stop --agent claude-code

diffle sessions

Section titled “diffle sessions”

List running diffle sessions with their host, port, age, and live/stale status.

Terminal window
diffle sessions

diffle cleanup [--yes] [--all]

Section titled “diffle cleanup [--yes] [--all]”

Stop stale sessions and finished reviews. --yes skips the confirmation; --all also stops active sessions.

Terminal window
diffle cleanup
diffle cleanup --yes
diffle cleanup --all --yes

diffle update

Section titled “diffle update”

Download and install the latest release. It verifies the download’s SHA-256 and refuses when a package manager owns the install. See Configuration for the full update behavior.

Terminal window
diffle update

diffle doctor [--fix] [--yes]

Section titled “diffle doctor [--fix] [--yes]”

Check the Claude Code plugin install for stale loupe-review leftovers and report what to repair. --fix runs the repair commands through the claude CLI; --yes skips the confirmation. See Migrating from loupe.

Terminal window
diffle doctor
diffle doctor --fix

Options

Section titled “Options”
flag meaning
-p, --port <n> serve on a fixed port (default: any free port)
--no-open don’t open the browser automatically
--review-id <id> open an existing durable Review Record
-v, --version print the installed version
-h, --help show help

The loupe alias

Section titled “The loupe alias”

The deprecated loupe command is an alias for diffle during the compatibility window. See Migrating from loupe.