Skip to content

Repository files navigation

delta

Delta

Review code diffs. Leave structured comments for your agents.

delta reviewing a diff in dark mode

Delta is a fast, beautiful desktop app for reviewing git changes. Read the diff, drop comments on the exact lines that matter, then copy the whole review as clean Markdown your AI coding agent can act on.

✨ Features

  • 🚀 Fast diffs — Smooth on huge changesets. Unified or split, word-level highlighting, syntax colors, fold/expand context, and find-in-diff.
  • 💬 Comments that stick — Comment on a line, range, or whole file in Markdown. They re-anchor as the diff shifts and flag themselves stale rather than silently drift. Resolve them once they're handled.
  • 🤖 Copy for agents — One click turns the review into clean, line-anchored Markdown an agent can act on — resolved comments drop out, stale ones are flagged. (See below.)
  • 🌿 Git-native — All changes, just uncommitted, the last commit, or branch-vs-base. Worktree-aware, and it re-diffs the moment files change.
  • 🧭 Made for flow — Files as a tree or list, mark-as-viewed, jump to your editor, command palette to hop between reviews.
  • 🎨 Light & dark — System, light, or dark theme.

🤖 Copy for agents

The reason Delta exists. Every comment becomes a self-contained instruction with its location and the code it refers to, grouped by file — so an agent has everything it needs without the original diff in front of it:

# Review — acme/api · feat/sessions · branch-vs-base
Base 8f2a1c0 ⇢ head 3e9b4d1 · captured 2026-06-29T10:12:00Z

## src/auth/session.ts

#### L2
```ts
return cache.get(user.id)
```
Use the store, not the cache.

#### L40–48 · ⚠ stale
```ts
export const TTL = 3600
```
Make this configurable.

🚀 Installation

On macOS (Apple Silicon):

brew install --cask darioielardi/tap/delta

Or grab the latest .dmg from the releases page. macOS, Apple Silicon (arm64) only.

💻 Open from your terminal

Install the delta CLI with the one-click Install CLI button. Then run it from any repo or worktree — ideal for reviewing an agent's work the moment it finishes:

delta                    # review the current repo — all changes
delta --uncommitted      # only staged + unstaged changes
delta --last-commit      # just the most recent commit
delta --branch           # current branch vs. its base

A path can follow any of these, e.g. delta --branch ../other-checkout.

🛠️ Development

pnpm dev:app                   # the app, isolated as "Delta Dev" — won't clash with an installed release
pnpm dev:mock                  # just the UI in a browser against fixtures → localhost:5599
pnpm start:demo                # build a throwaway review repo + open it (start:demo:stress for a giant one)
pnpm test                      # UI tests
cd src-tauri && cargo test     # Rust backend tests

dev:app runs the dev build as a separate app — its own identifier, data dir, and delta-dev CLI — so you can hack on delta while using a release build for real work. (pnpm tauri dev works too, but shares the release's identity.)

Architecture and conventions live in CLAUDE.md. PRs welcome — keep changes scoped and the tests green.

Privacy

Delta collects anonymous usage statistics (which features are used, app version, OS) to guide development — via Aptabase, which stores no personal data, cookies, or device identifiers. It never sends your code, file names, repository names, branch names, or comment text.

Turn it off in Settings → Usage analytics, or set DELTA_TELEMETRY=0 (or the standard DO_NOT_TRACK=1) in the environment.

Built with

Tauri 2 · React 19 · Vite · Tailwind v4 · @git-diff-view

License

MIT © Dario Ielardi

About

Fast, beautiful local-first desktop app for reviewing your agents work and leaving structured comments for them.

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages