Diffity provides a GitHub-style diff viewer and code review tool designed to work with various AI coding agents like Claude Code, Cursor, and Codex. It enables developers to visualize code changes locally, leave comments, and leverage AI for automated review and resolution, streamlining the code review process.

How It Works

Diffity operates as an agent-agnostic tool that runs within any Git repository. It renders syntax-highlighted diffs in a web browser, mimicking the GitHub Pull Request interface. Core functionality includes leaving comments on specific lines or files, which can then be processed by integrated AI agents via slash commands (/diffity-review, /diffity-resolve) to perform automated code reviews, suggest fixes, or apply resolutions directly.

Quick Start & Requirements

• Primary install: npm install -g diffity
• Prerequisites: Node.js/npm, Git, a web browser. The gh CLI is required for GitHub Pull Request integration.
• Usage: Run diffity in a Git repo to view uncommitted changes, or specify refs like diffity HEAD~1 for commit history, diffity main..feature for branch comparisons, or GitHub PR URLs.
• AI Integration: Install AI agent skills with npx skills add kamranahmedse/diffity.
• Links: No official documentation or demo links are provided in the README.

Highlighted Details

• Agent-agnostic, GitHub-style diff viewer for local code review.
• Supports commenting on diffs and integrating with AI agents for automated review (/diffity-review) and code changes (/diffity-resolve).
• Includes a diffity tree command for browsing project files with syntax highlighting and commenting capabilities.
• Can check out and review GitHub Pull Requests locally, pushing comments back to GitHub (requires gh CLI).

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap are present in the provided README snippet.

Licensing & Compatibility

• License: PolyForm Shield 1.0.0.
• Compatibility: Designed for Node.js/npm environments. Commercial use compatibility is governed by the Shield 1.0.0 license terms.

Limitations & Caveats

Functionality related to GitHub Pull Requests is dependent on the gh CLI being installed and authenticated. The tool requires a local Git repository and a web browser to operate.