Skip to content

logs

Usage
logs [-h] [-c <category>]

Interactively browses terminal log files (scrollback, paru, yay) sorted newest-first using fzf. Supports viewing in $PAGER, editing, and deletion.

Keybindings inside the fzf browser:

Enter Open in $PAGER
Ctrl+E Open in $EDITOR
Ctrl+D Delete (with confirmation)
? Toggle keybind help overlay

Paru and yay logs open in ov with syntax highlighting and sticky section headers. Scrollback logs open in ov with per-command sticky prompt headers based on OSC 133 markers.

Arguments:

-h, --help Show help message
-c, --category cat Filter to one category: scrollback, paru, or yay

Returns:

0 File viewed or no file selected
1 No log files found
Examples
logs -c paru
logs
logs -c scrollback