Tmux Workbench is a CLI/TUI tool for developers who keep long-running workspaces across local and remote machines.
It indexes tmux sessions, SSH servers, git state, workspace notes, aliases, tags, and AI-agent context files such as AGENTS.md, CLAUDE.md, and .cursorrules.
Why it exists
SSH and tmux are resilient, but they do not remember enough when work is spread across many servers and many coding-agent sessions. Tmux Workbench adds a local memory layer above tmux so a developer can find, inspect, and resume a workspace with one command.
Highlights
- Index local and remote tmux sessions over SSH.
- Attach by stable workspace ID:
<server>/<tmux-session>. - Browse workspaces in a TUI with search, server filtering, and active/archived views.
- Preserve notes, aliases, tags, status, and attach history across scans.
- Capture git branch, commit, dirty state, ahead/behind counts, and remote URL.
- Expose indexed AI-agent context through
ws agent <workspace>. - Store state locally in SQLite.
Tech
The project is written in Rust and distributed as a command-line binary named ws.