@monopi/pretty

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

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@monopi/pretty
Package
@monopi/pretty
Version
0.6.1
Published
Aug 28, 2026
Downloads
215/mo · 150/wk
Author
ifiokjr
License
MIT
Types
extension
Size
73.4 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

@monopi/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:@monopi/pretty

Or load locally:

pi -e ./packages/monopi__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.