Interactive Shell
Observable terminal overlays for Pi and other CLIs, with interactive, hands-free, and dispatch workflows.
What it does
Pi Interactive Shell gives Pi a real terminal overlay for interactive command-line programs. Instead of guessing at TUI output, Pi can launch and supervise Pi itself, Codex, Claude, editors, REPLs, SSH sessions, database shells, dev servers, and other long-running terminal workflows while you watch.
It supports three main ways of working: interactive for direct control, hands-free for monitored long-running sessions, and dispatch for fire-and-forget delegation that wakes Pi up when the session finishes. Background sessions can be reattached later, and the package also ships prompt templates and skills for agent-driven review and implementation workflows.
Why it's included
A lot of real developer tools are still terminal-first: editors like vim, SSH, watch mode test runners, database shells, long-running build processes, and other agent CLIs. Interactive Shell lets Pi work with those tools in a visible, controllable way instead of treating them as opaque subprocesses.
That makes it a strong fit for LazyPi: it expands what Pi can safely supervise without forcing you to leave the terminal. Upstream ships prebuilt PTY binaries via zigpty, so supported platforms do not need a native node-gyp toolchain just to install it.
Commands
| Command | What it does |
|---|---|
/spawn [agent] [prompt] |
Launch Pi, Claude, Codex, or another configured agent in an interactive overlay |
/spawn [agent] "prompt" --hands-free |
Start a monitored session that Pi can check in on while you watch |
/spawn [agent] "prompt" --dispatch |
Delegate work and wake Pi up when the session finishes |
/attach [session-id] |
Reconnect to a background or previously launched session |
/dismiss [session-id] |
Clean up a background session you no longer need |
You can also simply ask Pi in natural language to run something in dispatch or hands-free mode. The package exposes an interactive_shell tool under the hood, but end users normally work through slash commands or plain-English requests.