One workbench for every project, wherever it lives.
tmux-atelier keeps local and remote project workspaces together in the same tmux client.
A workspace starts with a directory on a machine. It can be local or reached over SSH. Open one, then give each part of the project its own tab: Neovim, an agent CLI, a plain shell, or whatever else you need.
New tabs and splits start on that machine in the project directory, ready for the next command.
One shortcut takes you to another workspace, even when the next project lives on a different machine. You do not have to detach, hunt down another session, reconnect, and find your way back to its directory.
The workspace interface feels modern. Underneath it, tmux keeps the sessions and processes alive, while OpenSSH handles remote connections.
Install it with:
curl -fsSL https://raw.githubusercontent.com/inayayousfi/tmux-atelier/main/install.sh | bashThe installer prints the line to add at the end of your tmux configuration. With the default installation path, it looks like this:
run-shell ~/.config/tmux/tmux-atelier/tmux-atelier.tmuxReload tmux and press your prefix followed by N to make your first workspace. If you keep plugins somewhere else, the installer accepts --install-dir.
Update an existing installation with curl -fsSL https://raw.githubusercontent.com/inayayousfi/tmux-atelier/main/install.sh | bash -s -- --update.
The installer supports Linux x86-64, Linux ARM64, and macOS Apple Silicon. Remote workspaces use the OpenSSH configuration and credentials you already have.
Configuration, commands, restoration behavior, Oh My Tmux integration, and recovery notes are in the full guide.
Useful places to start:
tmux-atelier uses Rust 2024 and requires Rust 1.89 or newer to build.
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-targets
./tests/install