README.md

spymux

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.

Installation

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:

Cross-platform

Package Manager	Package	Command
Cargo	spymux	cargo install spymux
Homebrew	terror/tap/spymux	brew install terror/tap/spymux

Pre-built binaries

Pre-built binaries for Linux, MacOS, and Windows can be found on the releases page.

Usage

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.3

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:
  -c, --commands <COMMAND>           Filter panes by command (comma-separated)
  -n, --no-colors                    Disable colored output
      --refresh-rate <MILLISECONDS>  Refresh interval in milliseconds (default: 500)
  -h, --help                         Print help
  -V, --version                      Print version

Keybindings

Action	Keys
Move up	↑ / k
Move down	↓ / j
Move left	← / h
Move right	→ / l
Focus highlighted pane	enter
Hide highlighted pane	x
Quit spymux	q / esc
Toggle help	?
Select clicked pane	left click

Prior Art

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.