pi-tui-commands

Interactive / command registry for pi — register any TUI tool as a slash command with binary-availability checks

Packages

Package details

extension

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

$ pi install npm:pi-tui-commands
Package
pi-tui-commands
Version
0.1.0
Published
Jul 19, 2026
Downloads
not available
Author
hs094
License
MIT
Types
extension
Size
16.2 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/tui-commands/index.ts"
  ],
  "image": "https://pi.dev/logo-auto.svg"
}

Security note

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

README

pi-tui-commands

Interactive / command registry for pi. Register any TUI tool (lazygit, nvim, htop, …) as a slash command that suspends pi while it runs and restores pi when you quit.

/tuicmd           Open the interactive manager
/tuicmd add htop  Register /htop as a command

Features

  • Interactive UI — /tuicmd opens a searchable toggle list (like /scoped-models) showing all known tools, their install status (✓/✗), and your enabled set.
  • Binary checks — Toggling a tool ON first checks if the binary exists on PATH. If not found, you get a message with a link to report the issue.
  • Custom commands — Register anything with /tuicmd add <name> [cmd].
  • Persistent — Your enabled set and custom commands survive restarts (stored in ~/.pi/agent/tui-commands.json).

Install

pi install git:github.com/<your-org>/pi-tui-commands

Then /reload inside pi and run /tuicmd.

Usage

Command What it does
/tuicmd Open interactive toggle list
/tuicmd add lg lazygit Register /lg → lazygit
/tuicmd rm lg Remove /lg
/lazygit (if enabled) Run lazygit

In the TUI:

  • Enter toggles a tool ON/OFF
  • / fuzzy-searches by name
  • Esc closes

How it works

When you toggle a tool ON, the extension:

  1. Checks which <binary> to verify it's installed
  2. Registers /toolname as a pi command via pi.registerCommand()
  3. The command handler calls ctx.ui.custom() to stop the TUI, spawns the process with stdio: "inherit", and restarts the TUI after the process exits

Development

git clone <url>
cd pi-tui-commands
pi -e ./extensions/tui-commands/index.ts

License

MIT