pi-terminal
Adds /terminal and /t commands to run shell commands in the current working directory and display output inline — with smart truncation and TUI notifications.
Package details
Install pi-terminal from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-terminal- Package
pi-terminal- Version
0.1.1- Published
- Mar 13, 2026
- Downloads
- 61/mo · 6/wk
- Author
- pierre-mike
- License
- MIT
- Types
- extension
- Size
- 4.7 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"."
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
💻 Terminal
Adds /terminal and /t commands to run shell commands in the current working directory and display output inline — with smart truncation and TUI notifications.
Install
pi install npm:pi-terminal
What it does
Registers two slash commands that execute arbitrary shell commands via bash -c with a 30-second timeout. Output is formatted with a header showing the command and working directory, then displayed as a TUI notification (for short output) or injected into the chat (for long output). Output is truncated to 200 lines / 20 KB with a tail-first strategy so the most relevant lines are always visible.
Commands
| Command | Description |
|---|---|
/terminal <command> |
Run a shell command and display output |
/t <command> |
Alias for /terminal |
Examples
/t npm test
/t git log --oneline -10
/terminal docker ps
Output behaviour
| Output size | Display |
|---|---|
| ≤ 20 lines and < 800 chars | TUI notification (inline popup) |
| Larger | Injected into chat as a fenced code block |
| > 200 lines or > 20 KB | Truncated — last N lines shown with a truncation note |
Exit code is always shown. Non-zero exits display as an error notification.