detached 4515dbd

docs: update history command documentation for interactive TUI

commit
4515dbd2aa7644e7a39c3df8c97a14471cdedc59
author
brice · · 2025-12-21 17:26 UTC
committer
brice · · 2025-12-21 21:15 UTC
parent
3ef7440
signature
unsigned
1 file · +4 -5
M README.md +4 -5
@@ -221,12 +221,11 @@ sudo apt install va-driver-all
221221 - rofi: `dumber dmenu | rofi -dmenu -show-icons -p "🔍 " | dumber dmenu --select`
222222 - fuzzel: `dumber dmenu | fuzzel --dmenu -p "🔍 " | dumber dmenu --select`
223223 - Manage browsing history:
224- - `dumber history` # list recent history (default: 20 entries)
225- - `dumber history list -n 50` # list 50 recent entries
226- - `dumber history search golang` # search history for "golang"
224+ - `dumber history` # interactive history browser (timeline tabs + fuzzy search)
225+ - `dumber history --json` # output recent entries as JSON
226+ - `dumber history --json --max 50` # limit JSON output to N entries
227227 - `dumber history stats` # show history statistics
228- - `dumber history clear` # clear all history (with confirmation)
229- - `dumber history clear --force` # clear all history (no confirmation)
228+ - `dumber history clear` # interactive cleanup (select time range)
230229 - Clean up data and cache:
231230 - `dumber purge` # purge all data (with confirmation)
232231 - `dumber purge --force` # purge all data (no confirmation)
@@ -221,12 +221,11 @@ sudo apt install va-driver-all
221 - rofi: `dumber dmenu | rofi -dmenu -show-icons -p "🔍 " | dumber dmenu --select`221 - rofi: `dumber dmenu | rofi -dmenu -show-icons -p "🔍 " | dumber dmenu --select`
222 - fuzzel: `dumber dmenu | fuzzel --dmenu -p "🔍 " | dumber dmenu --select`222 - fuzzel: `dumber dmenu | fuzzel --dmenu -p "🔍 " | dumber dmenu --select`
223 - Manage browsing history:223 - Manage browsing history:
224- - `dumber history` # list recent history (default: 20 entries)224+ - `dumber history` # interactive history browser (timeline tabs + fuzzy search)
225- - `dumber history list -n 50` # list 50 recent entries225+ - `dumber history --json` # output recent entries as JSON
226- - `dumber history search golang` # search history for "golang"226+ - `dumber history --json --max 50` # limit JSON output to N entries
227 - `dumber history stats` # show history statistics227 - `dumber history stats` # show history statistics
228- - `dumber history clear` # clear all history (with confirmation)228+ - `dumber history clear` # interactive cleanup (select time range)
229- - `dumber history clear --force` # clear all history (no confirmation)
230 - Clean up data and cache:229 - Clean up data and cache:
231 - `dumber purge` # purge all data (with confirmation)230 - `dumber purge` # purge all data (with confirmation)
232 - `dumber purge --force` # purge all data (no confirmation)231 - `dumber purge --force` # purge all data (no confirmation)

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 8

Tags 42

↑↓ moveenter openesc close