pi-tui-commands
Interactive / command registry for pi — register any TUI tool as a slash command with binary-availability checks
Package details
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 —
/tuicmdopens 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:
- Checks
which <binary>to verify it's installed - Registers
/toolnameas a pi command viapi.registerCommand() - The command handler calls
ctx.ui.custom()to stop the TUI, spawns the process withstdio: "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