@jalaxy33/pi-tmux-subagent

Observable Pi subagents that run in their own tmux session.

Packages

Package details

extension

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, and ls". That set is read-only; bash can 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.
  • /subagent lists this session's runs and attaches to one.