pix-write

Pi tool — file write with diff rendering.

What it does

Replaces Pi's default write tool with an enhanced version that renders a side-by-side split diff when overwriting an existing file. New files are shown with a syntax-highlighted preview (capped by default; expand to see the full content). The diff uses pix-pretty's diff engine: syntax-highlighted old/new panes with gutter markers, line numbers, and a change summary. Call labels show the target file path and write mode (create for new files, write for overwrites). Depends on @xynogen/pix-pretty, installed automatically as a dependency.

Auto-collapse

After a configurable delay (default 10 seconds), a completed write collapses to a one-line status row. Structured failures use a compact ✗ row after the delay. Expanding recomputes and restores the existing bounded preview or diff, or the exact diagnostic, without restarting the elapsed timer. This is controlled via the collapse section of ~/.pi/agent/pix.json:

{
  "collapse": {
    "enabled": true,
    "delaySec": 10,
    "tools": { "write": true }
  }
}

Set collapse.tools.write: false to disable for this tool only. See @xynogen/pix-runtime/collapse for the full API.

Install

pi install npm:@xynogen/pix-write

Bundled in @xynogen/pix-core. Install it alone only if you do not use pix-core.

Full distro

This package is part of Pix. The installer sets up Pi and the full distro. See Install for the notes for each OS.

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh

# Windows
irm https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.ps1 | iex

License

MIT