@diegopetrucci/pi-annotate-git-diff

A standalone pi extension that adds /annotate-git-diff, a native Glimpse UI for annotating git diffs and sending feedback to the editor.

Packages

Package details

extension

Install @diegopetrucci/pi-annotate-git-diff from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@diegopetrucci/pi-annotate-git-diff
Package
@diegopetrucci/pi-annotate-git-diff
Version
0.1.11
Published
Sep 1, 2026
Downloads
423/mo · 18/wk
Author
diegopetrucci
License
MIT
Types
extension
Size
197.2 KB
Dependencies
3 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

annotate-git-diff

A standalone pi extension that adds /annotate-git-diff, a native Glimpse window for reviewing git changes and sending structured feedback back to the current editor buffer.

Attribution

This extension was ported from the first-party The Last Harness implementation. It adapts the MIT-licensed @ryan_nookpi/pi-extension-diff-review implementation from the Jonghakseo/pi-extension monorepo and preserves its original inspiration credit to badlogic/pi-diff-review.

Install

pi install npm:@diegopetrucci/pi-annotate-git-diff

Then reload pi:

/reload

Usage

Run /annotate-git-diff inside a git repository. The command opens a native review window with:

  • Monaco-based diff viewing,
  • branch diff, per-commit including working tree, and all-files scopes,
  • inline, file-level, and overall review comments,
  • submit-to-editor feedback prompt insertion.

Submitting feedback does not auto-apply code changes. The extension appends a structured prompt to the current editor buffer so you can send that feedback back to the active agent.

The review UI does not fetch assets from a CDN. While the window is open, the extension serves its packaged Monaco graph from an ephemeral, tokenized HTTP server bound only to 127.0.0.1; closing, cancelling, submitting, startup failure, or Pi shutdown stops that server.

Requirements

  • Run inside a git repository.
  • Local desktop support for opening a native Glimpse window.
  • Packaged Monaco and Tailwind assets from this npm package.
  • POSIX shell utilities (bash, mktemp, base64, and tr) for some git snapshot/binary-file paths.

Troubleshooting

  • Review failed: Not inside a git repository. → change into a git repo and rerun /annotate-git-diff.
  • No reviewable files found. → make or fetch reviewable changes, then rerun.
  • Review failed: Glimpse host not found ... → the native window runtime is unavailable; reinstall/update the package and rerun from a machine/session that can open native windows.
  • Review failed: Unable to locate packaged ... runtime → reinstall/update the package so its declared Monaco and Tailwind dependencies are present, then rerun.