Tmux Workbench v0.1.2

Tmux Workbench v0.1.2

This release focuses on smoothing the first install experience.

Highlights

• Improve install.sh so new users can install with one command:

  curl -fsSL https://raw.githubusercontent.com/LeON-Nie-code/tmux-workbench/master/install.sh | bash

• Detect the current platform and download the matching binary.

• Prefer updating an existing ws installation when possible.

• Otherwise install into a user-owned directory such as ~/.local/bin.

• Avoid automatically writing into Homebrew-managed prefixes.

• Print the platform, selected asset, and target install path before download.

• Verify the installed binary after download.

• Print a shell-specific PATH fix when the install directory is not currently
  on PATH.

• Add ws --version.

• Simplify README installation docs so the install script is the clear default.

Install

curl -fsSL https://raw.githubusercontent.com/LeON-Nie-code/tmux-workbench/master/install.sh | bash

Notes

This is still a pre-1.0 release. CLI behavior, config format, and database
schema may still change while the project matures.

Tmux Workbench v0.1.1

Tmux Workbench v0.1.1

Tmux Workbench is now positioned around the workflow it was built for:

workspace memory for SSH, tmux, and AI coding agents.

This release adds agent-context indexing and a smoother attach experience.

Highlights

• Index AI agent instruction files in each workspace root:
  • AGENTS.md
  • AGENT.md
  • CLAUDE.md
  • GEMINI.md
  • .cursorrules
  • .windsurfrules
• Add ws agent <workspace> to inspect indexed agent context.
• Show agent docs in the TUI workspace detail view.
• Prefer coding-agent panes such as codex and claude when choosing a
  workspace root.
• Add a TUI loading state while preparing tmux attach, so slow remote checks no
  longer look like the UI is frozen.
• Improve README positioning for SSH + tmux + AI coding agent workflows.

Install

Install script

curl -fsSL https://raw.githubusercontent.com/LeON-Nie-code/tmux-workbench/master/install.sh | bash

macOS Apple Silicon

curl -L -o ws https://github.com/LeON-Nie-code/tmux-workbench/releases/download/v0.1.1/ws-macos-aarch64
chmod +x ws
mkdir -p ~/.local/bin
mv ws ~/.local/bin/ws

From source

cargo install --git https://github.com/LeON-Nie-code/tmux-workbench ws

Notes

This is still a pre-1.0 release. CLI behavior, config format, and database
schema may still change while the project matures.

Tmux Workbench v0.1.0

Tmux Workbench v0.1.0

Initial pre-release for private testing.

Tmux Workbench is a terminal workspace memory manager for local and remote tmux
sessions. The command is ws.

Highlights

• Index local tmux sessions and remote tmux sessions over SSH.
• Manage servers with ws servers, ws add-server, and ws remove-server.
• Open a TUI with workspace search, server filtering, view modes, and notes.
• Attach back to a tmux workspace by stable ID: <server>/<tmux-session>.
• Capture git branch, commit, dirty state, ahead/behind counts, and remote URL.
• Preserve notes, aliases, tags, status, and attach history across scans.
• Detect missing tmux sessions without overwriting archive state.
• Scan servers concurrently with command timeouts.

Install

macOS Apple Silicon

curl -L -o ws https://github.com/LeON-Nie-code/tmux-workbench/releases/download/v0.1.0/ws-macos-aarch64
chmod +x ws
mkdir -p ~/.local/bin
mv ws ~/.local/bin/ws

From source

cargo install --path .

Notes

This is a pre-1.0 release. CLI behavior, config format, and database schema may
still change while the project matures.

Full Changelog: https://github.com/LeON-Nie-code/tmux-workbench/commits/v0.1.0