Using it
The leader
^a, then a key: tmux’s prefix, for acting on sessions from inside one.
Inside a session every key belongs to the session, which is where you spend your time. The leader is how you act on sessions from in there. It is tmux’s prefix, on the key its users already have under their thumb: ^a, and then one more key. It works from the lists too.
After ^a
| Key | What it does |
|---|---|
| c | Start a session: Claude Code, Codex, a shell, or NeoVim. |
| s | A shell in the project’s checkout, straight away. |
| t | A shell beside this session, in its worktree. |
| e | NeoVim beside this session, in its worktree. |
| n | The next session in this project. |
| p | The one before. |
| l | The session you were in before this one. |
| [ | Scroll back through this session, with Vim’s keys. q goes back to typing. |
| 1-9 | A session by its place in the list. |
| ( ) | The project before, and the next. |
| w | Out of the terminal, back to the lists. |
| x | End this session. |
| d | Out of this session, back to the lists. From the lists, out of voodoo. Sessions keep running either way. |
| ? | These keys. |
| ^a | Type a real ^a into the session. |
While the leader is armed, the session rows show the numbers that bring them up. The list orders itself by what needs you, so a number is only worth knowing at the moment you press it. A key that isn’t in the table is swallowed and types nothing.