mcpField
D
diffity-diff

diffity-diff

github.com/nilbuildDevelopment8951.7k installsUpdated 1d ago
Repository

About diffity-diff

A skill for viewing code changes in a browser with Diffity, targeting working tree changes, Git refs, or GitHub PRs. It checks for and installs the CLI if needed, starts or reuses a server, and provides its URL.

Key features

  1. 01View working tree, Git ref, or PR diffs
  2. 02Check for and install the diffity CLI
  3. 03Start or reuse a repository instance in background
  4. 04Get the port and browser URL

Use cases

  1. 01Inspect current working tree changes in a browser
  2. 02View differences between specified Git refs
  3. 03Open a GitHub PR diff

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nilbuild/diffity --skill diffity-diff

After installing, type/diffity-diffin Claude Code to confirm it loaded.

Details

From the project README

Diffity Diff Skill

You are opening the diffity diff viewer so the user can see their changes in the browser.

Arguments

  • ref (optional): Git ref to diff (e.g. main..feature, HEAD~3) or a GitHub PR URL (e.g. https://github.com/owner/repo/pull/123). Defaults to working tree changes.

Instructions

  1. Check that diffity is available: run which diffity. If not found, install it with npm install -g diffity.

  2. Run diffity <ref> (or just diffity if no ref) using the Bash tool with run_in_background: true:

    • The CLI handles everything: if an instance is already running for this repo it reuses it and opens the browser, otherwise it starts a new server and opens the browser.
    • Do NOT use & or --quiet — let the Bash tool handle backgrounding.

  3. Wait 2 seconds, then run diffity list --json to get the port.

  4. Tell the user diffity is running. Print the URL and keep it short — don't show session IDs, hashes, or other internals. Example:

    Diffity is running at http://localhost:5391

    When you're ready:

    • Leave comments on the diff in your browser, then run /diffity-resolve to fix them
    • Or run /diffity-review to get an AI code review

Comments

Markdown supported