tmuxito

tmux sessions made simple, because you forgot what was running...

A terminal UI for managing tmux sessions — browse, attach, rename, kill, and preview sessions without ever leaving the keyboard.

Built with Textual.

---

Features

• Session list with status (attached/detached), window count, and creation time
• Live preview of the selected session via tmux capture-pane
• Drill into windows — attach directly to a specific window
• Inline search — filter sessions by typing /
• Sort by name, creation date, or attached status
• Full keyboard and mouse support
• Contextual footer that updates per screen
• Help screen (?) with a full tmux keybinding reference
• Config file for persistent preferences

---

Requirements

• Python 3.10+
• tmux (any reasonably recent version)

---

Installation

With pipx (recommended)

pipx install git+https://github.com/bradstallion/tmuxito.git

After installation the tmuxito command is available globally.

With pip inside a virtualenv

pip install .

For development

git clone https://github.com/bradstallion/tmuxito.git
cd tmuxito
python -m venv venv
source venv/bin/activate
pip install -e .

---

Usage

tmuxito

Or, without installing:

python -m tmuxito

---

Keybindings

Session list

Key	Action
n	New session
r	Rename selected session
k	Kill selected session (confirmation prompt)
Enter	Attach to selected session
→	Drill into session windows
/	Filter / search sessions (Esc to cancel)
s	Cycle sort: name → date → attached
R	Refresh list
?	Help screen
q	Quit

Window list

Key	Action
Enter	Attach to selected window
n	New window
r	Rename selected window
k	Kill selected window (confirmation prompt)
Esc	Back to session list

Help screen

Key	Action
Esc / q	Close

---

Configuration

tmuxito reads ~/.config/tmuxito/config.toml on startup. The file is optional; all settings have defaults.

# Skip the "Kill session?" confirmation dialog
skip_kill_confirmation = false

# Default sort order: "name" | "date" | "attached"
default_sort = "name"

# UI theme: "dark" | "light"
color_theme = "dark"

---

Running tests

python -m pytest tests/