spymux is a terminal user-interface for simultaneously watching all of your open tmux panes.

Why? I pair program a fair amount with tools like codex, and I run them in different projects (windows) at the same time. I'd like a tool that gives me a clear view into what the agents are doing, without having to switch between them.

spymux should run on any system, including Linux, MacOS, and the BSDs.

The easiest way to install it is by using cargo, the Rust package manager:

cargo install spymux

Otherwise, see below for the complete package list:

spymux is very simple to use, once installed you should be able to invoke the binary in any tmux session and have it work:

spymux

We support a few configuration options, as seen below:

spymux 0.1.1

A centralized view for all of your tmux panes

Usage: spymux [OPTIONS] [COMMAND]

Commands:
  resume  Resume a spymux session in another directory
  help    Print this message or the help of the given subcommand(s)

Options:
  -n, --no-colors                    Disable colored output
      --refresh-rate <MILLISECONDS>  Refresh interval in milliseconds (default: 500)
  -h, --help                         Print help
  -V, --version                      Print version

This project is loosely inspired by tools like Claude Squad. I want less of the management aspect, and more of a simple view into how things are going across the various agent instances I have open at any given time.