@xynogen/pix-read

Pi tool — file read with syntax highlight

Packages

Package details

extension

Install @xynogen/pix-read from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@xynogen/pix-read

Package: @xynogen/pix-read
Version: 0.1.15
Published: Jul 18, 2026
Downloads: 2,667/mo · 417/wk
Author: xynogen
License: MIT
Types: extension
Size: 15.7 KB
Dependencies: 2 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "src/extension.ts"
  ]
}

Security note

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

README

pix-read

Pi tool — file read with syntax highlighting.

What it does

Replaces Pi's default read tool with an enhanced version backed by pix-pretty. File content is syntax-highlighted using cli-highlight (highlight.js-backed) with language auto-detection. The call label shows the shortened file path, with optional from line N and (N lines) hints. Images are displayed with mime type and byte size and a type icon. Long files are shown with a line count and truncation notice; expanded mode reveals the full content. Depends on @xynogen/pix-pretty, installed automatically as a dependency.

Auto-collapse

After a configurable delay (default 10 seconds), completed output collapses to a row such as ✓ read src/index.ts · 120 lines. Structured failures use a compact ✗ row after the delay. Expanding recomputes and restores the normal bounded preview or 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": { "read": true }
  }
}

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

Install

pi install npm:@xynogen/pix-read

Also included in @xynogen/pix-core:
pi install npm:@xynogen/pix-core

Full distro

Source: github.com/xynogen/pix-mono

To install the complete pix suite (all packages + Pi itself):

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

License

MIT