Skip to content

Scrollback

Attyx maintains a scrollback buffer that preserves terminal output after it scrolls off the visible screen. You can scroll back through history, search it, and copy text from it.

[scrollback]
lines = 20000
[reflow]
enabled = true
OptionTypeDefaultDescription
linesinteger20000Scrollback buffer size in lines. Set to 0 to disable.

The scrollback buffer is implemented as a bounded ring buffer — when it fills up, the oldest lines are discarded to make room for new ones.

OptionTypeDefaultDescription
enabledbooleantrueReflow text when the terminal is resized

When reflow is enabled, long lines that were wrapped due to a narrow terminal width will re-wrap when you make the terminal wider. This preserves the logical structure of text across resize events.

When disabled, wrapped lines stay wrapped regardless of terminal size changes.

ActionmacOSLinux
Scroll page upShift+Page UpShift+Page Up
Scroll page downShift+Page DownShift+Page Down
Scroll to topShift+HomeShift+Home
Scroll to bottomShift+EndShift+End

These can be rebound in the [keybindings] table. See the Keybindings docs for details.

Use the in-terminal search (Cmd+F / Ctrl+F) to search through scrollback history, or enter Visual Mode and use / or ? to search forward or backward.

FlagDescription
--scrollback-lines <int>Scrollback buffer size
--reflow / --no-reflowEnable/disable reflow

Scrollback lines is hot-reloadable. Increasing the value preserves existing history; decreasing it trims the oldest lines.