Setup & MCP

First-run wizard, skills install, and MCP client configuration.

Setup wizard

diffing setup
diffing setup --yes
diffing setup --check
diffing setup skills
diffing setup mcp
diffing setup mcp --write-mcp
diffing setup mcp --write-project-mcp

--write-mcp merges only the diffing key into known IDE MCP configs and backs up under ~/.diffing/backups/. Other servers are preserved.

Skills

npx skills add ahmedragab20/diffing

Skill	When
`diffing`	Route any diffing request
`diffing-start-review`	Launch UI for human
`diffing-finish-review`	Process handoff comments
`diffing-review`	Agent posts inline review
`diffing-plan-review`	Plan gate before code
`diffing-pr-read`	Bounded PR inspection
`diffing-pr-address`	Turn PR feedback into local work

pi extension

pi install git:github.com/ahmedragab20/diffing
pi install npm:diffing

The extension lives at extensions/pi/index.ts and registers 18 diffing_* tools mirroring the MCP catalog — status, start_review, comments, reply/resolve/unresolve, progress, await_review, plan submit/await/list/show/reply/resolve, url, sessions, gh_overview, and a CLI escape hatch. It also adds a /diffing command that opens or reuses the review UI and a footer status widget showing the active review session.

Note: When pi runs inside the diffing repo itself, ~/.agents/skills/diffing* should be symlinks to .agents/skills/*. pi dedupes skills by realpath, so symlinked entries merge silently with the repo’s project skills; the extension self-heals these links to avoid skill-collision warnings.

MCP server

diffing mcp
diffing mcp --repo /absolute/path/to/repo

Client config:

{
  "mcpServers": {
    "diffing": {
      "command": "diffing",
      "args": ["mcp"]
    }
  }
}

No port in the config. Repository is --repo or the git root of the MCP process cwd. Invalid selection fails instead of guessing.

First tool calls

review_session_status — inspect binding / nextAction
start_review_session — only when needed (idempotent; never replaces user sessions)
Then diff inspect, comments, plan, or gh_* as appropriate

See MCP tools for the full 37-tool catalog.

Doctor & completions

diffing doctor
diffing completion zsh
diffing completion bash
diffing completion fish