@ifi/pi-pretty

Pretty terminal output for pi — syntax-highlighted file reads, colored bash output, tree-view directory listings, and more.

Package details

← Back
extension

Install @ifi/pi-pretty from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@ifi/pi-pretty
Package
@ifi/pi-pretty
Version
0.5.1
Published
Apr 28, 2026
Downloads
222/mo · 222/wk
Author
ifiokjr
License
MIT
Types
extension
Size
73.5 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

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

README

@ifi/pi-pretty

Pretty terminal output for pi built-in tools.

Features

  • read — Syntax-highlighted file content with line numbers + inline image rendering
  • bash_pretty — Colored exit status with output preview
  • ls — Tree-view directory listing with Nerd Font file type icons
  • find / grep — FFF-backed frecency-aware search with grouped/highlighted rendering
  • multi_grep — OR-search across multiple patterns

Install

pi install npm:@ifi/pi-pretty

Or load locally:

pi -e ./packages/pi-pretty/index.ts

Usage

Use the wrapped tools directly:

read path="src/index.ts"
bash_pretty command="pnpm test"
ls path="src"
grep pattern="handleRequest" glob="*.ts"

Commands

  • /fff-health — Check FFF index status
  • /fff-rescan — Force rescan of current directory
  • /multi-grep patterns=["foo","bar"] glob="*.ts" — OR grep multiple patterns

Configuration

Environment variable Default Description
PRETTY_THEME github-dark Shiki highlighting theme
PRETTY_MAX_HL_CHARS 80000 Skip highlighting above this
PRETTY_MAX_PREVIEW_LINES 80 Max lines in preview
PRETTY_CACHE_LIMIT 128 LRU highlight cache size
PRETTY_ICONS nerd Icon set (nerd or none)

License

MIT — Ifiok Jr.