tmux tutor

Learn tmux interactively -- like vimtutor, but for tmux.

28 hands-on lessons that teach you tmux by having you actually use it. No slides, no videos -- just your terminal, a tutor script, and live verification that checks your work after every lesson.

Features

• 28 interactive lessons across two modules (basics + advanced)
• Live verification -- the tutor inspects your tmux state and confirms you did it right
• No install required beyond bash and tmux -- just clone and run
• Progress saving -- quit any time and resume where you left off
• HTML reference companion covering all 28 lessons plus a quick reference card

Quick start

git clone https://github.com/alejandroerickson/tmuxtutor.git
cd tmuxtutor
./tmuxtutor

When you finish the basics, continue with:

./tmuxtutor-advanced

Run without installing

Try it instantly -- no clone needed:

bash <(curl -sL https://raw.githubusercontent.com/alejandroerickson/tmuxtutor/main/tmuxtutor)

For the advanced module:

bash <(curl -sL https://raw.githubusercontent.com/alejandroerickson/tmuxtutor/main/tmuxtutor-advanced)

How it works

Open two terminal windows (or tabs). In the first, run ./tmuxtutor. The tutor displays a lesson and tells you what to do. In the second terminal, execute the tmux commands it asks for. When you think you have it right, press [v] in the tutor to verify -- it checks your live tmux state and tells you whether you passed.

HTML reference companion

A self-contained reference covering all 28 lessons and a quick reference card is available at alejandroerickson.com/tmuxtutor.

Screenshots

Lesson 14 -- Build a Workspace (capstone)

Completing the basics module

Advanced module introduction

Advanced Lesson 6 -- Move Panes Between Windows

Advanced Lesson 9 -- Editing tmux.conf in a split view

Advanced Lesson 13 -- SSH and tmux

Completing all 28 lessons

Requirements

• bash
• tmux

Install tmux if you don't have it:

# Ubuntu / Debian
sudo apt install tmux

# macOS (Homebrew)
brew install tmux

# Fedora
sudo dnf install tmux

# Arch
sudo pacman -S tmux

License

MIT