pi-show-diffs

Pi package that adds a diff approval viewer before edit and write tools change files.

Package details

← Back
extension

Install pi-show-diffs from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-show-diffs
Package
pi-show-diffs
Version
0.2.8
Published
Apr 6, 2026
Downloads
870/mo · 141/wk
Author
xryul
License
MIT
Types
extension
Size
115.3 KB
Dependencies
2 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "video": "https://github.com/user-attachments/assets/8bda7619-fcd2-4615-a93a-d15b2fee408b"
}

Security note

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

README

pi-show-diffs

warp.dev inspired pi extension that stops and shows an editable diff before file changes are applied.

https://github.com/user-attachments/assets/8bda7619-fcd2-4615-a93a-d15b2fee408b

It currently reviews:

  • edit
  • hashline_edit
  • write

This gives pi an interactive pre-apply diff review step, so you can inspect the proposed change first and then decide whether to allow it.

Diff review UX

For normal file changes, the modal uses a split diff viewer with:

  • side-by-side Original / Updated columns
  • syntax-aware ANSI highlighting for common code file types
  • collapsed unchanged regions with clear labels
  • hunk-aware navigation
  • unified diff fallback for narrow terminals or preview errors
  • live toggle between split and unified views
  • inline editing for edit, write, and valid hashline_edit previews directly inside the diff modal
  • adjustable context expansion around hunks
  • wrapped inline rendering for long lines

Install

Install from npm:

pi install npm:pi-show-diffs

Or install directly from GitHub:

pi install git:github.com/xRyul/pi-show-diffs

Commands

  • /diff-approval — open or toggle approval settings
  • /show-diffs — alias for /diff-approval

Command args:

  • /diff-approval on
  • /diff-approval off
  • /diff-approval toggle
  • /diff-approval status

Shortcuts in the diff modal

Approval actions

  • Enter, a, or y - approve
  • r or Esc - reject
  • E or e - enter inline edit mode for the updated side
  • Esc in inline edit mode — leave editing and return to review mode
  • s - steer and add feedback
  • Shift+A - approve and turn on auto-approve

Navigation

  • ↑ / ↓ - scroll
  • PgUp / PgDn - jump by page
  • Home / End — jump to top/bottom
  • n / p - next / previous hunk
  • inline edit mode: Ctrl+N / Ctrl+P jump hunks; Alt/Option + ↑ / ↓ also works if your terminal is configured to send Alt

View controls

  • Tab - toggle split / unified view
  • ← / → — decrease / increase shown context around hunks
  • [ / ] - alternate context controls
  • w - toggle wrapping

Config

Persistent config is stored at:

~/.pi/agent/extensions/pi-show-diffs.json

Current config shape:

{
  "autoApprove": false
}

Notes

  • no edit/write tool overrides are registered, so it stays compatible with other tool-wrapping extensions like collapse-tools.ts
  • non-interactive mode falls back to a text-based diff review flow
  • steering rejects the current proposal and sends your feedback back to the model
  • editing final file content applies immediately for edit, write, and hashline_edit after the original tool call succeeds
  • auto-approve restores normal behavior until you turn it off again
  • invalid hashline_edit previews (for example tag mismatches) skip the review modal and fall through to the tool's normal error handling