<h1 align="center"ttmux</h1
<p align="center"<emA modern multiplexer alternative.</em</p
<p align="center" <a href="https://github.com/statico/ttmux/actions/workflows/ci.yml"<img alt="CI" src="https://github.com/statico/ttmux/actions/workflows/ci.yml/badge.svg"</a <a href="https://github.com/statico/ttmux/releases"<img alt="Release" src="https://img.shields.io/github/v/release/statico/ttmux?includeprereleases&sort=semver"</a <a href="LICENSE"<img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue.svg"</a <img alt="Rust 1.82+" src="https://img.shields.io/badge/rust-1.82%2B-orange.svg" <img alt="Platforms" src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-lightgrey.svg" </p
<p align="center"<img alt="ttmux demo" src="docs/demo.gif" width="700"</p
[!WARNING] Beta software. ttmux is still under test. Expect bugs, and expect the config format to change before 1.0.
[!NOTE] Made entirely with Claude Code. Every line of this project was written by Claude.
ttmux runs many terminals in one window, like tmux or screen. It adds floating panes, real mouse support, curved borders, and a settings screen that you open inside the app.
Install
With Homebrew, on macOS or Linux:
brew install statico/tap/ttmuxOr build it from source, which needs Rust 1.82 or later:
cargo install --git https://github.com/statico/ttmuxThen start it:
ttmuxPrebuilt binaries for macOS and Linux are also on the releases page.
Why
tmux works well and has decades of muscle memory behind it. But a fresh tmux needs a .tmux.conf and plugins like tmux-sensible before it stops getting in the way. ttmux ships with those defaults.
| | tmux, out of the box | ttmux | |---|---|---| | Escape key | a delay after <kbdesc</kbd (500ms before 3.5) | no delay, so vim leaves insert mode at once | | Scrollback | 2,000 lines | 10,000 lines | | Mouse | off | on: click, drag, resize, and wheel | | Color | truecolor and undercurl need terminal-overrides | truecolor and undercurl | | Focus events | off | on | | Clipboard | ignores OSC 52 from programs | copies to your clipboard, or set clipboard = false | | Modern keys | extended-keys off, so shift+enter is lost | kitty keyboard and modifyOtherKeys | | Images | sixel if built in, the rest need allow-passthrough | kitty, iTerm2, and sixel, even mpv video, and nothing but images | | Config | .tmux.conf, source-file by hand | TOML, reload with the prefix and <kbdr</kbd, or a settings screen | | Discovering keys | a list behind the prefix and ? | a which-key popup and a command palette | | Layout | tiling | tiling or free-floating, drag and drop | | Agents | — | a per-pane busy, needs-you, or done mark |