@simplecyon/pi-minimal-tui

Compact, low-noise TUI rendering for Pi built-in tools

Packages

Package details

extensiontheme

Install @simplecyon/pi-minimal-tui from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@simplecyon/pi-minimal-tui

Package: @simplecyon/pi-minimal-tui
Version: 0.3.2
Published: Jul 29, 2026
Downloads: 76/mo · 76/wk
Author: simplecyon
License: MIT
Types: extension, theme
Size: 32.5 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

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

README

@simplecyon/pi-minimal-tui

Compact, low-noise rendering for Pi's built-in tool events, plus the cyon-minimal-dark theme.

What it changes

Collapsed tool calls render as one descriptive line, such as ·read docs: extensions.md.
Consecutive bash, read, grep, find, and ls actions collapse into a count summary.
A single action keeps its descriptive verb-and-target row.
Bash failures stay compact while retaining outcomes such as timeout or exit status.
Collapsed edits show a high-contrast compact diff with one context line, a single omission marker between distant change groups, and subtle theme-adaptive green/red backgrounds on added and removed rows.
read, bash, edit, write, grep, find, and ls use background-free self-rendered shells.
Ctrl+O continues to use Pi's native expanded state and restores full native output, including syntax highlighting, images, errors, timing, and complete diffs.
cyon-minimal-dark gives user messages a subtle cool-gray highlight while keeping tool and custom-message surfaces quiet.

write is summarized as a file operation rather than shown as an invented diff: Pi's write result does not contain the previous file content.

Install

Install only this package:

pi install npm:@simplecyon/pi-minimal-tui

For one trusted project:

pi install npm:@simplecyon/pi-minimal-tui -l --approve

The complete suite remains available as git:github.com/simplecyon/pi-packages.

Restart Pi, then select:

/theme
cyon-minimal-dark

The extension removes tool backgrounds regardless of the active theme, except for the deliberate shallow highlight on collapsed edit diff rows. The bundled theme additionally tunes user-message and fallback surface colors.

Deliberate boundaries

The package does not simulate thinking duration, automatic thinking collapse, or mouse interaction because Pi 0.82.x does not expose those interactive-core hooks to packages.

It decorates public built-in tool definitions rather than reimplementing tool execution. Renderer contracts can still change between Pi minor versions.

Development

From the monorepo root:

pnpm --filter @simplecyon/pi-minimal-tui check
pi install -l --approve /absolute/path/to/pi-packages/packages/pi-minimal-tui

See the repository README for suite installation and workspace conventions.