CLI reference

Primary command

diffing [options] [<revision>...] [-- <path>...]

Drop-in for git diff revisions, options, and pathspecs. On a TTY, opens the preferred interactive UI; otherwise prints a unified patch.

Server / session options

Flag	Description
--port <port>	Fixed port; default is a random free port
--host <host>	Bind address (default 127.0.0.1)
--insecure-no-auth	Required with wildcard binds (0.0.0.0/::); disables API auth, including loopback tokens
--no-open	Do not auto-open browser
--reuse-session	Open active session and exit
--replace-session	Stop active, then start with current args
--web	Force web UI
--terminal	Force stdout patch
--view	Read-only native viewer
--tui	Full native review TUI (experimental)
--gh-pr <ref>	GitHub PR session
--skip-setup	Bypass first-run setup gate
--staged / other git flags	Same semantics as git diff

Git-compatible flag groups

Revisions/range · algorithms · whitespace · context · word-diff · renames/copies · output formats · filtering · output control — 60+ flags across 12 categories. Output-format flags force terminal mode.

Examples:

diffing --staged
diffing HEAD~3
diffing main..feature
diffing -w -- src/
diffing --stat              # terminal mode

Subcommands

Command	Role
commands [--json] [command]	Discover available commands and actions
sessions …	List / use / open / stop live sessions
mode [web|tui]	Get/set default interactive mode
await-review	Sync wait for Send to agent
comments	Dump comments (XML/JSON/md)
reply / resolve / unresolve	Thread lifecycle
comment edit / comment delete	Mutate threads
progress	Live agent progress toast
url	Active base URL
inspect …	Bounded diff reads
plan …	Plan review loop
mockup …	Mockup review loop
design …	Per-repo design system
gh …	GitHub PR automation
mcp	Stdio MCP server
setup / init / onboard	First-time wizard
doctor	Environment self-check
completion <shell>	Shell completions
update	Self-upgrade via npm/pnpm
view	Read-only TUI viewer

commands

List the command catalog or filter it to one exact command name. No Git repository or running review server is required.

diffing commands
diffing commands plan
diffing commands --json
diffing commands --json init

JSON output contains schemaVersion: 1 and a commands array. Entries contain name and description, plus optional actions (action names) and aliasFor (the canonical command name). The filtered init response is:

{
  "schemaVersion": 1,
  "commands": [
    {
      "name": "init",
      "description": "Alias for setup",
      "aliasFor": "setup",
      "actions": ["skills", "mcp"]
    }
  ]
}

The catalog is discovery metadata, not a complete argument or flag schema. Unknown commands/options and extra command names exit with code 5. Bash, Zsh, and Fish completions share the command and action catalog.

sessions

diffing sessions
diffing sessions --json
diffing sessions use <id>
diffing sessions open [<id>|active]
diffing sessions stop <id>|active|all

mode

diffing mode
diffing mode web
diffing mode tui

Stored as defaultMode in settings. Applies only on interactive TTY without an explicit mode flag.

await-review

diffing await-review [-t|--timeout <seconds>]

Default timeout 570. Exit 0 / 2 / 3 / 5. Prefer async park when the human is not reviewing now.

comments

diffing comments [--open] [--json] [--format xml|json|md|markdown]

reply / resolve / unresolve

diffing reply <id> --body <text> [--model <name>]
diffing resolve <id>
diffing unresolve <id>

Body may be - or stdin for reply.

progress

diffing progress --message "Working…" [--model M] [--pct 40]

url

diffing url

inspect

diffing inspect summary [--exclude lockfiles]
diffing inspect files [--path GLOB]
diffing inspect hunks --file <n> | --path GLOB
diffing inspect slice --file <n> | --path GLOB [--start R] …
diffing inspect search --query "…" [--path GLOB]

Token-efficient alternative to dumping the full patch. Mirrors MCP diff_* tools.

plan

diffing plan submit [<file>|-] [--title T] [--source S] [--model M] [--id ID] [--wait] [--timeout N] [--save-source|-S]
diffing plan await [--timeout N]
diffing plan list [--json]
diffing plan show [<id>] [--version n] [--json]
diffing plan versions <id>
diffing plan reply <comment-id> --body <text> [--model M]
diffing plan resolve <comment-id>

gh

diffing gh status
diffing gh overview
diffing gh threads
diffing gh reviews
# plus pr-fetch / pr-list-comments / pr-review (see deep CLI in repo docs/cli.md)

mcp

diffing mcp [--repo /abs/path]

setup / doctor / update

diffing setup [--yes] [--check] [--reset]
diffing doctor
diffing update
diffing completion zsh

Exit codes

See Exit codes.

Source

Deep historical manual: repository docs/cli.md (superseded by this site for public docs; retained for cutover). Verified against CLI sources for v0.13.x.