title: feat: a ? help overlay status: closed labels: [] created: 2026-09-14 closed:

The keys were only in the footer, and only for the screen you were on, in a terse form.

? now opens an overlay listing every key that does something on the current screen with a one-line description, plus the keys that work everywhere. It is an overlay rather than a screen, so the screen underneath keeps its scroll and cursor and closing it returns exactly where the user was; ? or esc closes it; ctrl+c still quits; and while it is open it takes every other key, so nothing fires by accident while somebody is reading it.

The list is derived from one function per screen that returns key/description pairs, and the footer now renders its hints from the same list, so the two cannot drift apart. Conditional states are included: the browse filter, the journal action menu (where enter means confirm), and the review screen when an album that is already in the library has taken k and r for keep-both and replace, leaving the arrow keys as the only way to scroll up.

It fits the terminal and degrades sanely on a small one: it drops screen keys before global ones, and on a tiny terminal shows a single line saying how to close it.