Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Peek

Check on a session’s terminal output without attaching:

muster peek myproject               # all tabs, last 50 lines each
muster peek myproject Shell         # specific tab only
muster peek myproject -n 10         # last 10 lines per tab
muster peek myproject --json        # machine-readable output

Peek uses tmux capture-pane to grab scrollback from each tab. It’s a read-only operation that doesn’t affect the session.

Death Snapshots

When a tab’s process exits, muster captures the last 50 lines of output before cleaning up the dead tab. Snapshots are saved to ~/.config/muster/logs/<session_name>/<tab_name>.last.

Files are overwritten on each death event per tab name, keeping the directory small. The last few lines are included in the desktop notification body when notifications are enabled.

This preserves output that would otherwise be lost when tmux cleans up dead tabs — useful for seeing why a build or server crashed without having been attached at the time.