{"_id":"@blazer2k/pi-ui-enhancements","name":"@blazer2k/pi-ui-enhancements","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@blazer2k/pi-ui-enhancements","version":"0.1.0","description":"Visual polish and compact tool rendering for pi.","type":"module","keywords":["pi","pi-package"],"author":{"name":"Fedor Vasilev"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/blazer2k/pi-blz.git","directory":"packages/pi-ui-enhancements"},"bugs":{"url":"https://github.com/blazer2k/pi-blz/issues"},"homepage":"https://github.com/blazer2k/pi-blz/tree/main/packages/pi-ui-enhancements#readme","publishConfig":{"access":"public"},"dependencies":{"figlet":"^1.11.0"},"peerDependencies":{"@earendil-works/pi-ai":"*","@earendil-works/pi-coding-agent":"*","@earendil-works/pi-tui":"*","typebox":"*"},"pi":{"extensions":["./src/index.ts"],"image":"https://raw.githubusercontent.com/blazer2k/pi-blz/main/packages/pi-ui-enhancements/images/example.webp"},"gitHead":"a214f3c1c365f2f5b5775f73ac9937abbf5b9d3c","_id":"@blazer2k/pi-ui-enhancements@0.1.0","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-nw5WBK994gNlaVeh6c195qEi5KdrZ7pcBxUuDhUROC+GYBVeRtc6qA4AI3dVWxTWuvYijx/wkeTJ2zebH36VEQ==","shasum":"a622ddc088636a64acdcf86978205e637a2711a5","tarball":"https://registry.npmjs.org/@blazer2k/pi-ui-enhancements/-/pi-ui-enhancements-0.1.0.tgz","fileCount":39,"unpackedSize":404705,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDI6GK5v9U67ZYBPwZBFgMII8EIt19nayFphFk9h+hq0wIhAOi3JsnuISs2NVTa5qhotQRGLfJdQv27/xrslYwX3FVo"}]},"_npmUser":{"name":"blazer2k","email":"blazer2kforever@gmail.com"},"directories":{},"maintainers":[{"name":"blazer2k","email":"blazer2kforever@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-ui-enhancements_0.1.0_1782694386874_0.020102988987241055"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-29T00:53:06.760Z","0.1.0":"2026-06-29T00:53:07.068Z","modified":"2026-06-29T00:53:07.236Z"},"maintainers":[{"name":"blazer2k","email":"blazer2kforever@gmail.com"}],"description":"Visual polish and compact tool rendering for pi.","homepage":"https://github.com/blazer2k/pi-blz/tree/main/packages/pi-ui-enhancements#readme","keywords":["pi","pi-package"],"repository":{"type":"git","url":"git+https://github.com/blazer2k/pi-blz.git","directory":"packages/pi-ui-enhancements"},"author":{"name":"Fedor Vasilev"},"bugs":{"url":"https://github.com/blazer2k/pi-blz/issues"},"license":"MIT","readme":"# @blazer2k/pi-ui-enhancements\n\nVisual polish and compact tool rendering for [pi](https://pi.dev).\n\n**Current version:** 0.1.0\n\n## Overview\n\nThis extension adds visual improvements to pi's TUI:\n\n- Configurable ASCII art header at session start, rendered via figlet or the bundled Greek pi fonts.\n- Rounded border around the editor showing cwd, git branch, model, token usage, and context percentage.\n- Shimmer animation on the \"Working\" label with elapsed duration and an interrupt hint.\n- Compact tree-drawing summaries for tool output instead of verbose raw output. Paths are hyperlinked when your terminal supports it. Third-party tools get wrapped too (see below).\n- Optional capitalization for custom tool call labels, enabled by default.\n\n![Example: compact tool output with ASCII header](images/example.webp)\n\n![Example: rounded editor border with working indicator](images/editor.webp)\n\n## Installation\n\n```bash\npi install npm:@blazer2k/pi-ui-enhancements\n```\n\nOr install locally for development:\n\n```bash\ngit clone https://github.com/blazer2k/pi-blz.git\ncd pi-blz\nnpm install\npi -e ./packages/pi-ui-enhancements/src/index.ts\n```\n\n## Configuration\n\nRun `/ui` in pi to open the settings menu.\n\n### Available Settings\n\n| Setting                | Description                                                                        |\n| ---------------------- | ---------------------------------------------------------------------------------- |\n| Enable ASCII header    | Show ASCII art header at session start                                             |\n| Header font            | Font for ASCII art header (19 figlet fonts + 2 bundled, default: Greek)           |\n| Header color           | Theme color of ASCII header (text, accent, dim)                                    |\n| Header alignment       | Horizontal alignment (left, center, right)                                         |\n| Show version           | Display pi version below ASCII header                                              |\n| Show interrupt hint    | Show \"esc to interrupt\" next to the working indicator                              |\n| Show run duration      | Show elapsed time while working, toast on completion                               |\n| Patched built-in tools | Which built-in tool renderers to replace (essential or all)                        |\n| Patch custom tools     | Apply compact rendering to third-party tools                                       |\n| Capitalize tool names  | Capitalize custom tool call labels (default: true, e.g. search → Search)           |\n| Max call width         | Maximum width for tool call and output lines                                       |\n| Max expanded entries   | Maximum lines when expanding tool output (-1 for unlimited), doesn't apply to bash |\n| Editor border color    | How the editor border is colored (thinking, dim, muted)                            |\n| Show thinking level    | Display thinking level in editor footer                                            |\n| Show cache tokens      | Display cache read/write token counts                                              |\n| Show cost              | Display total session cost in editor footer                                        |\n| Show git branch        | Display current git branch in editor header                                        |\n\n### Built-in Tool Patches\n\nThe `patchedBuiltInTools` setting has two modes:\n\n- **essential** (default): read, write, edit, bash\n- **all**: adds ls, find, grep\n\nChanges here require `/reload` since tool renderers are registered at load time. Everything else applies immediately.\n\n### Third-Party Tool Monkey-Patching\n\nBy default, the extension monkey-patches `ExtensionRunner.prototype.getAllRegisteredTools` to intercept third-party tool definitions and wrap their output in the same compact format. Built-in tools and tools with `renderShell: \"self\"` are left alone.\n\nCustom tool call labels are capitalized by default while preserving the tool's own `renderCall()` layout when possible. For example, `mcp` becomes `Mcp`.\n\nIf you prefer third-party tools to render natively, disable `patchCustomTools` in the settings menu. If you prefer lowercase custom tool labels, disable `capitalizeToolNames`.\n\n## Persistence\n\nSettings are saved to `~/.pi/agent/ui-settings.json` and restored on each session. Override the path with `PI_UI_ENHANCEMENTS_CONFIG_PATH`.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-9dc870bd4af38b7ab01832282224f79b"}