Skip to content

Keep "? help" on the top bar while the shortcut bar is hidden - #533

Merged
robzolkos merged 2 commits into
mainfrom
help-hint-when-hidden
Sep 30, 2026
Merged

robzolkos merged 2 commits into
mainfrom
help-hint-when-hidden

Conversation

@robzolkos

@robzolkos robzolkos commented Sep 30, 2026 •

Copy link
Copy Markdown
Collaborator

Pressing ? hid every shortcut, including the ? that brings them back. The choice is saved across restarts, so it was easy to end up with a clean screen and no hint of how to get help again.

While help is hidden, the top rule now starts with ? help:

── ? help ──────────────── HEY ──────────── All Accounts ──

It sits on a row that's already drawn, so hiding help still gives you back every row it did before. HEY stays centred, and on a terminal too narrow to fit the hint beside it, the hint is left out. I considered keeping one ? help line in the bottom bar instead, but that brings back the divider and its spacing, about four rows, which undoes the point of hiding help.

Basecamp card: https://app.basecamp.com/2914079/buckets/48521764/card_tables/cards/10357270119

Recorded against the local dev server. Each take opens the TUI, presses ?, quits, reopens (help is still hidden), and presses ? again.

Before After
before after

Summary by cubic

Keeps ? help visible on the top bar while the shortcut bar is hidden, so users always have a way to bring help back.

Bug Fixes

  • Pressing ? previously hid every shortcut, including ? itself, and the choice survived restarts, leaving no hint of how to get help again.
  • The hint sits on the existing top rule, so hiding help still returns every row it did before and HEY stays centered; it is left out when the terminal is too narrow to fit it beside HEY.
  • An error box swallows every key until dismissed, so the hint is hidden while one is showing to keep it in step with the key.

Written for commit 6b5e6db. Summary will update on new commits.

Review in cubic

Pressing ? hid every shortcut, including the one that brings them back, and
the choice survives a restart, so it was easy to end up with no way of
knowing how to get help again. While help is hidden the top rule now opens
with "? help". It takes no rows, so hiding help still gives the screen back,
and it is left out when the terminal is too narrow to fit it beside HEY.
@robzolkos
robzolkos requested a review from a team as a code owner September 30, 2026 17:06
Copilot AI balanced review requested due to automatic review settings September 30, 2026 17:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The hint remains visible during an error dialog, when its shortcut cannot be used.

Review effort: Balanced
Findings: 1 Medium severity

Open (1)
What changed in this PR

This PR keeps the shortcut to restore hidden help visible in the TUI without giving up the screen space gained by hiding the shortcut bar.

Changes:

  • Adds ? help to the top rule when help is hidden and there is room.
  • Adds layout and toggle tests, and updates the TUI guide.

[!TIP]
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

File Description
internal/​tui/​tui_test.go Tests the hint, centering, and narrow layouts.
internal/​tui/​nav.go Renders the hint on the top rule.
docs/​tui.md Explains how to restore hidden help.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread internal/tui/nav.go
An error box takes every key until it is dismissed, so ? did nothing while
the header still offered it. canToggleHelp now says no while an error is
showing, which keeps the hint and the key in step.
@robzolkos
robzolkos merged commit c5f71c5 into main Sep 30, 2026
25 checks passed
@robzolkos
robzolkos deleted the help-hint-when-hidden branch September 30, 2026 17:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants