Skip to content

fix(tui): surface hidden keybindings#65

Merged
BunsDev merged 1 commit into
mainfrom
codex/issue-56-keybinding-discoverability
Jun 11, 2026
Merged

fix(tui): surface hidden keybindings#65
BunsDev merged 1 commit into
mainfrom
codex/issue-56-keybinding-discoverability

Conversation

@BunsDev

@BunsDev BunsDev commented Jun 11, 2026

Copy link
Copy Markdown
Member

Summary

  • add F2, Alt+H, Ctrl+B, and Tab mode-cycle hints to the footer
  • add the same hidden shortcuts to the full help overlay and legacy help fallback
  • extend onboarding page 2 with familiar/help/branch shortcuts and regression coverage

Verification

  • cargo test -p claurst-tui footer_exposes_hidden_keybinding_hints && cargo test -p claurst-tui help_overlay_lists_hidden_keybinding_hints && cargo test -p claurst-tui onboarding_keybindings_page_renders
  • git diff --check
  • cargo fmt -p claurst-tui --check
  • cargo test -p claurst-tui
  • cargo check -p claurst

Note: cargo fmt --all --check is blocked by unrelated formatting drift in current main under crates/cli and crates/core.

Fixes #56

Copilot AI review requested due to automatic review settings June 11, 2026 03:23
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jun 11, 2026 3:23am

@BunsDev BunsDev merged commit a49e464 into main Jun 11, 2026
2 checks passed
@BunsDev BunsDev deleted the codex/issue-56-keybinding-discoverability branch June 11, 2026 03:23

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR improves keybinding discoverability in the TUI by surfacing previously “hidden” shortcuts (F2, Alt+H, Ctrl+B, and Tab mode cycling) across the footer, help UI, and onboarding page 2, and adds regression tests to ensure these hints remain visible.

Changes:

  • Add footer hints for F2 / Alt+H / Ctrl+B / Tab when the prompt is idle.
  • Extend both the full help overlay and the legacy/simple help overlay with the same shortcuts.
  • Extend onboarding keybindings page (page 2) with familiar/help/branch shortcuts and add rendering assertions.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
src-rust/crates/tui/src/render.rs Adds footer hint text, expands legacy help key list, and adds a footer regression test.
src-rust/crates/tui/src/overlays.rs Adds the hidden shortcuts to the full help overlay and adds a regression test.
src-rust/crates/tui/src/onboarding_dialog.rs Adds new keybinding rows to onboarding page 2 and extends the render test assertions.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


if app.prompt_input.text.is_empty() && !app.is_streaming {
spans.push(Span::styled(
"F2 familiar Alt+H help Ctrl+B branch Tab mode",
Comment on lines 2967 to +2971
kb_line("F1 / ?", "Toggle this help"),
kb_line("Alt+H", "Toggle this help"),
kb_line("F2", "Switch familiar"),
kb_line("Ctrl+B", "Create / switch branch"),
kb_line("Tab", "Cycle mode (build/plan/explore)"),
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Keybinding discoverability: F2, Alt+H, Ctrl+B, and Tab mode cycling are hinted nowhere

2 participants