Skip to content

gi-dellav/multistack

Repository files navigation

banner

Multistack

Run multiple zerostack agents side by side in your terminal, allowing to spawn, watch, rename, kill all underlying processes.

Multistack is designed to be a native, lightweight and open-soruce competitor to Conductor.

What it does

  • Spawn parallel agents: each one gets its own PTY, running zerostack --parallel under the hood
  • Live status tracking: see at a glance who's working [~], done [✓], dead [X], or waiting [ ], with per-agent timers
  • Drop into any agent: hit Enter on a process to see its full terminal output, keystrokes pass straight through
  • Status signal support: multistack listens for start/stop signals from zerostack via Unix sockets, so timers and indicators stay accurate even across headless loop iterations

Install

NOTE: Multistack is currently in beta stage, and requires zerostack v1.5, which is also in a beta stage.

cargo install zerostack --version 1.5.0-rc4   # Run if you don't have zerostack v1.5+
cargo install multistack --version 1.0.0-rc2

You need zerostack on your PATH, plus a recent Rust toolchain.

Keybindings

Key Action
n Spawn a new agent (prompts for a name)
Enter Open the selected agent's TTY
r Rename selected agent
k Kill selected agent
/ Move selection
Esc Leave TTY / dismiss prompt / quit
q Quit

Inside a TTY view, all keystrokes forward to the agent. Press Esc to go back to the list.

Requirements

  • Linux/BSD/macOS (uses Unix domain sockets and PTYs)
  • zerostack v1.5+ built with the status-signals feature (default from v1.5)
  • Rust 1.85+ (2024 edition)

License

GPL-3.0-only

About

Open source lightweight TUI for parallel agent management

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages