@jalaxy33/pi-tmux-subagent
Observable Pi subagents that run in their own tmux session.
Package details
Install @jalaxy33/pi-tmux-subagent from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@jalaxy33/pi-tmux-subagent- Package
@jalaxy33/pi-tmux-subagent- Version
0.1.2- Published
- Nov 20, 2026
- Downloads
- 343/mo · 26/wk
- Author
- jalaxy33
- License
- MIT
- Types
- extension
- Size
- 47.8 KB
- Dependencies
- 0 dependencies · 3 peers
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-tmux-subagent
Forked from badlogic/pi-subagent. Observable, persistent Pi subagents for independent reviews, investigations, and delegated implementation. Each one runs in its own tmux session with a dedicated Pi session, so you can watch it work, steer it, wait for its result, or attach to its terminal.
Requirements
- Pi
- tmux
Windows is not supported, because tmux has no native Windows build. Run Pi inside WSL2 instead. When tmux is missing, the extension registers no tool or command and reports the reason on session start.
Runs live under ~/.pi/agent/subagents and are only listed by the session that spawned them. A run whose parent session file was deleted is removed on the next session start.
Install
pi install npm:@jalaxy33/pi-tmux-subagent
# or from source
pi install git:github.com/jalaxy33/pi-tmux-subagent
Run /reload in an existing Pi session. The extension registers the subagent tool and its skill; there is no symlink to create and no PATH entry to add. The checkout also contains subagent.ts, which offers the same commands as a CLI for scripts.
Usage
Ask for a subagent in plain language:
Start a subagent named review that checks the current diff independently, then stop it once it has reported back.
- It inherits your provider, model, thinking level, and working directory. Ask for files, another model, or another directory when you need them.
- Restrict its tools by naming them, for example "give it only
read,grep,find, andls". That set is read-only;bashcan also write files, so leave it out for reviews. - Ask Pi to wait for the result, forward instructions while it works, rename the run, or stop it.
/subagentlists this session's runs and attaches to one.