@kkskcs/pi-diff-inline

Render diffs inline in the pi conversation stream

Packages

Package details

extension

Install @kkskcs/pi-diff-inline from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@kkskcs/pi-diff-inline
Package
@kkskcs/pi-diff-inline
Version
0.1.3
Published
Jun 16, 2026
Downloads
not available
Author
kkskcs
License
MIT
Types
extension
Size
39.8 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/extensions/diff-inline/index.js"
  ],
  "image": "https://raw.githubusercontent.com/kkskcs/pi-lego/develop/packages/pi-diff-inline/assets/preview.png"
}

Security note

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

README

@kkskcs/pi-diff-inline

Render diffs inline in the pi conversation stream. Supports unified diff text input and text-to-text comparison with inline token highlighting.

Screenshots

Split mode (default)

split

Unified mode

unified

Features

  • Inline diff rendering in the conversation stream (no full-screen TUI)
  • Split (side-by-side, default) and unified view modes
  • Inline token highlighting — only changed tokens are highlighted
  • Background color tinting for added/removed/context lines
  • File boundary markers (^, $, ⋮) with frame lines
  • Hanging gutter continuity on wrapped lines
  • Multi-block text-to-text comparison (diffs array)
  • Expandable/collapsible state

Installation

pi install npm:@kkskcs/pi-diff-inline

Usage

Tool: diff_inline

Called by the LLM to render diffs inline.

Parameters:

Parameter Type Description
diffText string Unified diff text (git diff, diff -u, etc.)
oldText string Original text for comparison
newText string New text for comparison
diffs array Multi-block comparison: [{oldText, newText, label?}]
label string Header label shown above the diff
mode "split" | "unified" View mode (default: split)
contextLines number Context lines for text-to-text mode (default: 3)
expandable boolean Enable collapsed/expanded toggle (default: false)

Provide either diffText, oldText/newText, or diffs — not multiple.

Command: /diff-inline

/diff-inline <free-form text describing what to compare>

The input is sent to the LLM, which interprets the request and calls diff_inline with appropriate parameters.

Development

pnpm install
pnpm run test
pnpm run build

Credits

Renderer architecture inspired by pi-hashline-readmap.