Documentation
Command timeline
A centered overlay of the commands run in the focused pane — with durations and exit status — built from OSC 133 shell-integration marks.
The command timeline is a quick, keyboard-driven history of what you ran in the focused pane. Open it with Cmd+Shift+M (macOS) / Ctrl+Shift+M (Linux / Windows) or from the command palette, and a centered overlay lists each command with how long it took and whether it succeeded. Pick one and jump the scrollback straight to it.
What each row shows
- Command text — the line you ran, as captured at the prompt.
- Duration — wall-clock time from the command starting to finishing.
- Status dot — green for exit 0, red for a non-zero exit, and a live dot for a command that's still running.
Keyboard & mouse
| Input | Action |
|---|---|
| Cmd+Shift+M / Ctrl+Shift+M | Toggle the timeline open / closed. |
| Up / Down | Move the selection between commands. |
| Enter | Jump the scrollback to the selected command and close. |
| Esc | Close the timeline without moving. |
OSC 133 prompt/command marks that power the
Cmd+Shift+Up / Down prompt-jump shortcuts. These are
emitted by standard shell-integration snippets (zsh, bash, fish). Without
them toowl can't tell where one command ends and the next begins, so the
timeline stays empty until your shell is emitting the marks.
The timeline is hidden while a full-screen app (vim, htop, less, …) owns the alt-screen — those apps repaint themselves and don't produce command marks.
Rebind
The action name is toggle_timeline. Change the chord in the
[keybindings] table of
~/.config/toowl/config.toml:
[keybindings]
"ctrl+shift+m" = "toggle_timeline"Or rebind visually from the palette — see the Keybindings page.