Keybindings

The TUI action catalog, default keys, and the fixed navigation keys.

The TUI's keys are data-driven. A closed catalog of named actions is bound to keys by a default keymap, and control.keys in the config rebinds or unbinds any of them. See The TUI for how rebinding works.

control:
  keys:
    x: restart          # x now also restarts (r still works unless unbound)
    ctrl+r: restart-all
    enter: ""           # empty value unbinds a key

Key strings use bubbletea's form, for example r, R, ctrl+c, shift+tab, enter, esc, and a single space " " for the spacebar. Binding a key to an action name outside the catalog is a hard error at load time, and mapping a key to an empty string unbinds it and drops it from the help modal.

Action catalog

Every action is bound out of the box by the default keymap.

Action	Default key(s)	Description
`restart`	`r`	restart the focused service
`restart-all`	`R`	restart all services
`insert-blank`	`enter`	insert a blank line into the focused output
`next-tab`	`right`	next tab
`prev-tab`	`left`	previous tab
`next-child`	`tab`	focus the next container (docker tab)
`prev-child`	`shift+tab`	focus the previous container (docker tab)
`hist-back`	`[`	back to the previously viewed tab
`hist-forward`	`]`	forward in tab history
`clear`	`k`	clear the focused tab buffer
`clear-all`	`K`	clear all buffers
`cursor-mode`	`e`	toggle cursor mode (line cursor and selection)
`cursor-up`	`up`	scroll up (cursor up in cursor mode)
`cursor-down`	`down`	scroll down (cursor down in cursor mode)
`extend-up`	`shift+up`	extend selection up
`extend-down`	`shift+down`	extend selection down
`toggle-select`	`space`	toggle the cursor line in the selection
`copy`	`c`	copy selection (or cursor line) to the clipboard
`clear-cursor`	`esc`	clear selection / exit cursor mode
`write-selection`	`w`	rewrite `<svc>.selected.log` with the selection
`append-selection`	`a`	append the selection to `<svc>.selected.log`
`toggle-logs`	`L`	toggle log-file writing
`command-center`	`/`, `?`	open the help / key-bindings modal
`toggle-zen`	`z`	toggle zen mode
`quit`	`q`, `ctrl+c`	quit

A few log-navigation keys sit outside the rebindable keymap so they are always available. control.keys cannot touch these.

Key	Action
`1`-`9`	jump to tab
`pgup` / `pgdn`	page up / down
`home` / `end`	scroll to top / bottom

Mouse and touchpad scrolling also work.

Edit or read the source on GitHub

Action catalog

Fixed navigation