pi-compact-tools

Compact, expandable UI for pi's built-in tools, bundled with a polished GitHub Dark theme.

Packages

Package details

extensiontheme

Install pi-compact-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-compact-tools
Package
pi-compact-tools
Version
0.9.0
Published
Sep 20, 2026
Downloads
2,370/mo · 2,370/wk
Author
nedleeds
License
MIT
Types
extension, theme
Size
107.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/nedleeds/pi-compact-tools/main/assets/compact-workflow.gif",
  "themes": [
    "./themes/github-dark-pro.json"
  ],
  "extensions": [
    "./extensions/compact-tools.ts"
  ]
}

Security note

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

README

pi-compact-tools

Compact, expandable rendering for Pi's built-in tools, with a GitHub Dark theme.

Compact rows for every built-in tool

Syntax-highlighted edit diff

Numbered read code view

Features

  • Compact rows for read, write, edit, bash, powershell, grep, find, and ls, with status, duration, and line count
  • Syntax-highlighted edit diffs and numbered read/write code views, including Markdown code fences
  • Animated working label above the prompt, lit in the session's own thinking-level color, and a Ctrl+T thinking summary/detail cycle
  • Theme-agnostic chrome: rails, the tool indicator, and the working label are derived from the active theme and stay legible on light and dark backgrounds
  • No Nerd Font required

Install

pi install npm:pi-compact-tools

Then restart Pi or run /reload. For the bundled theme, set "theme": "github-dark-pro" in ~/.pi/agent/settings.json.

Configuration

Optional. Put it in ~/.pi/agent/compact-tools.json or <project>/.pi/compact-tools.json:

{
  "tools": ["read", "write", "edit", "bash"],
  "previewLines": 10,
  "auto_compact": { "read": true, "write": true, "edit": false, "bash": true }
}
  • tools: tools to render compactly. Also available: grep, find, ls, powershell.
  • auto_compact: true starts hidden, false starts with a preview of up to previewLines rows (1–100).

Controls

  • Click a row or press Ctrl+O to expand or collapse results.
  • Ctrl+T cycles thinking: summary → detail → summary → hidden.

Development

npm install
npm run check
pi -e .

License

MIT