@nandithebull/pi-background
v1.0.0
Published
Background task tracker extension for pi - shows running commands and background sessions in the UI
Maintainers
Readme
@nandithebull/pi-background
Background task tracker extension for pi.
Shows when pi is running tasks in the background or when the agent is actively working. Displays status in the footer and provides commands to manage background sessions.
Features
- Shows "● working" when the agent is processing
- Tracks running bash commands (shows command preview while executing)
- Tracks interactive_shell background sessions
- Widget below editor shows running commands and sessions with elapsed time
Installation
npm install @nandithebull/pi-backgroundOr run directly with pi:
pi -e @nandithebull/pi-backgroundCommands
| Command | Description |
|---------|-------------|
| /bg | List active background sessions and running commands |
| /bg-attach | Attach to a background session |
| /bg-dismiss | Dismiss all background sessions |
Usage
The extension automatically tracks:
- Agent working state (shows timer while processing)
- Running bash commands with elapsed time
- Background interactive_shell sessions (hands-free and dispatch modes)
Place in ~/.pi/agent/extensions/ for auto-discovery.
License
MIT
