tmux

#ToResearch #Knowledge #coding

tmux perserves a terminal session, making it useful when remotely accessing machines, especially with sessions that might drop

Concepts:

session
pane like a window
window like a tab
buffer like a clipboard(?)

Commands:

tmux new [-s $title] // create new session
tmux a [-t $title] // attach this terminal to session
tmux list-sessions // show active sessions w/ details

tmux Internal Commands:

ctrl b // tmux command mode {prefix}
ctrl b + $ // rename active session
ctrl b + , // command mode, rename active window
ctrl b + : // command mode, labeled command

https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/tmux.md

Workflows

Save terminal output to file

• ctrl b + : + // command mode, labeled command
• capture-pane [-S -100] capture the pane's (last 100 lines) output to a buffer
• ctrl b + : + // command mode, labeled command
• save-buffer [output-file.txt]

Use Windows

• ctrl b + c // create window (new tab)
• ctrl b + n // next tab
• ctrl b + , // rename tab
• ctrl b + & // close tab

Use Panes

• ctrl b + " split pane along x axis (a top and bottom)
• ctrl b + % split pane along y axis (left & right)
• ctrl b + { go left a pane
• ctrl b + } go right a pane

copy mode

• ctrl-b enter command mode
• copy mode is the mode to search the buffer
• ctrl-s enters search prompt to enter the string
• enter searches the term
• n = 'next', shift - n = reverse 'next' (back)
• escape twice to exit copy mode