@xynogen/pix-ls

Pi tool — directory listing with tree view

Packages

Package details

extension

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

npm repo home report

$ pi install npm:@xynogen/pix-ls

Package: @xynogen/pix-ls
Version: 0.1.15
Published: Jul 18, 2026
Downloads: 2,511/mo · 421/wk
Author: xynogen
License: MIT
Types: extension
Size: 13 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-ls

Pi tool — enhanced directory listing.

What it does

Replaces Pi's default ls tool with an enhanced version backed by pix-pretty. Output is rendered with file/directory icons and a total entry-count header. Call labels show the target path inline. Depends on @xynogen/pix-pretty, installed automatically as a dependency.

Display style

The listing layout is configurable via pretty.lsStyle in ~/.pi/agent/pix.json:

Value	Description
`"grid"`	Horizontal columns, like `eza`/`ls` (default)
`"tree"`	Vertical tree with `├──`/`└──` connectors

{
  "pretty": {
    "lsStyle": "grid"   // or "tree"
  }
}

Auto-collapse

After a configurable delay (default 10 seconds), completed output collapses to a row such as ✓ ls packages · 29 entries. Structured failures use a compact ✗ row after the delay. Expanding restores the configured listing 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": { "ls": true }
  }
}

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

Install

pi install npm:@xynogen/pix-ls

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