Remember every workspace
Index local and remote tmux sessions with server, path, panes, active command, notes, tags, and attach history.
Terminal workspace memory
Find the right tmux session before context goes cold.
Tmux Workbench is a Rust CLI/TUI for developers who work across local and remote tmux sessions, SSH servers, and long-running AI coding agents.
curl -fsSL https://raw.githubusercontent.com/LeON-Nie-code/tmux-workbench/master/install.sh | bash
copy
A memory layer above tmux.
tmux keeps processes alive. Tmux Workbench keeps the surrounding project context searchable, inspectable, and attachable.
Built for SSH-heavy work
Use your existing ssh config, keys, ProxyCommand, and cloud-generated hosts. Tmux Workbench calls system ssh.
AI agent context
Detect Codex, Claude Code, Gemini, Aider, and project instruction files such as AGENTS.md and CLAUDE.md.
Git-aware detail view
See branch, commit, dirty state, ahead or behind counts, and remote repository URL before you attach.
Fast local memory
Workspace state is stored locally in SQLite, so notes and history survive rescans and missing remote sessions.
One command back to work
Open ws, search or filter, hit Enter, and attach to the right tmux session without remembering the server.
Designed for real SSH + tmux work.
If every project has a server, a tmux session, a few panes, and an AI agent running inside it, Tmux Workbench gives that workflow a front door.
Add your machines
Register local and remote servers once with normal ssh commands.
Scan tmux sessions
Collect active panes, commands, paths, git state, and agent docs.
Resume by memory
Search by server, status, tag, git state, or plain project text.
Install in one command.
The installer downloads the latest release binary, verifies that ws is on PATH, and prints the exact fix if your shell cannot find it.
curl -fsSL https://raw.githubusercontent.com/LeON-Nie-code/tmux-workbench/master/install.sh | bash
ws doctor
ws add-server prod --ssh "ssh prod"
ws scan
wsOr use your package manager.
Tmux Workbench can also be installed from Cargo, Homebrew, or a manually downloaded GitHub Release binary.
- Homebrew
brew install LeON-Nie-code/tmux-workbench/ws - Cargo
cargo install --git https://github.com/LeON-Nie-code/tmux-workbench ws - Manual
download the release binary and place it on PATH
Open ws. Pick the workspace. Attach.
Tmux Workbench is open source and built around the terminal workflow many AI-heavy developers already use every day.