docs: find in the terminal — ⌘F / ⌘⇧F, and why it reads transcripts - #175
Merged
Conversation
Documents hearth's new find overlay in the keybindings cheatsheet and the shell guide, including the part that isn't obvious: in an agent pane it searches the Claude transcript rather than the terminal grid, because Claude Code renders in the alt-screen and the alt-screen has no scrollback for either search or dump-screen to read. Also records that pane fullscreen moved from ⌘F to ⌘⏎ (⌘F now means find, matching trill's ⌘F and every other app on the machine), the two new Ghostty unbinds, and the ⌘⇧/ ≡ ⌘? Help-menu overlap with its fallback. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017kESRpGfc5TMCxid7Ac4Dj
JulienMartel
temporarily deployed
to
nebelhaus.com / PR #175
August 3, 2026 17:22 — with 
GitHub Actions
Inactive
GitHub Actions
Inactive
Follows nebelhaus/nebelhaus#192. The ⌘⇧/ ≡ ⌘? Help-menu caveat goes with them, since there is no longer a chord to caveat. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017kESRpGfc5TMCxid7Ac4Dj
JulienMartel
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Docs for the find overlay landing in the rice (nebelhaus/nebelhaus#192).
reference/keybindings.md—Super FandSuper ⇧Frows,Super ⏎for fullscreen, a note on where the searched text actually comes from, and the two new Ghostty unbinds.guides/the-shell.mdx— a Finding things section under the zellij keybindings, plus the overlay's in-app keys.Why
The non-obvious part is worth writing down, not just the keys: in an agent pane the overlay searches the Claude transcript rather than the terminal grid. That isn't a shortcut — Claude Code renders in the alt-screen here, and the alt-screen has no scrollback, so searching the grid would only ever find what is on display that second.
Also records that pane fullscreen moved
⌘F→⌘⏎.⌘Fnow means find, which is what it already means in trill (⌘Ffind-in-thread,⇧⌘Fglobal search) and in every other app on the machine.The zellij-native-search aside is deliberate: the overlay does not replace
Ctrl g→s//, and the docs shouldn't imply it does. Native search is still the only thing that highlights in place and walks matches withn/p.Verify
web/has nonode_modulesin this session, so the site was not built. Worth anpm run buildinweb/before merge to confirm the MDX compiles.Two things to eyeball:
<Aside type="note">inthe-shell.mdx—Asideis already imported at the top of that file, andnoteis a valid Starlight type.[Finding things](#finding-things)anchor from the keybindings table row resolves to the new heading.Prose-only otherwise; no code, no config, nothing to activate.
Watch-out
Merge order: this describes behaviour that only exists once the rice PR lands. Worth merging after nebelhaus/nebelhaus#192, or at least not shipping the site ahead of it, so nebelhaus.com doesn't document keys the current release doesn't have.
If #192 changes during review — particularly if the
⏎/^y/^sin-overlay keys move — the keybindings table, the Finding things section, and the Ghostty-note paragraph all need the same edit.