Getting Started

Install

brew install oswaldoacauan/tap/diffgotchi

macOS and Linux, via Homebrew. Other install methods live on the releases page.

Review what's changed

cd into a git repo with uncommitted changes and run:

diffgotchi

That reviews the unstaged changes — what git diff would show you. A few common variants:

diffgotchi --staged                # staged changes
diffgotchi main                    # diff vs main (base...HEAD)
diffgotchi main feat               # diff between two refs
diffgotchi --commit abc123         # a single commit
diffgotchi --filter "*.tsx"        # only files matching a glob

The diff refreshes the moment a file changes on disk, so you can keep diffgotchi open while your agent works.

Scoped reviews

If you're juggling multiple reviews on the same branch, give them names:

diffgotchi --session api-review
diffgotchi --session ui-cleanup

Each session keeps its own comments and done state. Switch by re-running with a different --session.

Pick a theme

30 themes ship in the box. Open the command palette (Ctrl+P) and search "theme" to preview and switch.

Next

• Usage — keybinds, comments, the agent loop.