UAT: TUI help panel missing many spec-required hotkeys — `tab`, `ctrl+tab`, `ctrl+[/]`, `ctrl+n`, `ctrl+w`, `shift+tab` not listed #5062

New issue

Closed

opened 2026-04-09 00:53:17 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 00:53:17 +00:00

Owner

Bug Report

Feature Area: TUI — Help Panel (F1) / Hotkey Reference

Severity: Low (documentation gap)

What Was Tested

The help panel content as defined in the specification (§ Help Panel (F1), §Hotkey Reference).

Expected Behavior (from spec)

The F1 help panel should show context-sensitive hotkeys. For the Main Screen, the spec defines these hotkeys:

Global:

ctrl+q — Quit TUI immediately
ctrl+c — Interrupt actor / double-tap to quit
F1 — Toggle help panel
F2 / ctrl+, — Open settings
ctrl+s — Open Sessions screen
ctrl+n — Create new session tab
ctrl+w — Close current session tab
ctrl+[ / ctrl+] — Switch to previous / next session tab
shift+tab — Cycle sidebar: hidden → visible → fullscreen
escape — Close current overlay / modal / sidebar

MainScreen — Prompt Focused:

tab — Cycle to next persona
ctrl+tab — Cycle to next argument preset
up (at row 0) — Previous prompt history entry
down (at last row) — Next prompt history entry
@ — Open Reference Picker overlay
/ (at position 0) — Open Slash Command overlay
! or $ (at position 0) — Activate shell mode
backspace (at position 0 in shell mode) — Deactivate shell mode
ctrl+b — Focus sidebar (when visible)

Actual Behavior (from code analysis)

The _GLOBAL_ITEMS in src/cleveragents/tui/widgets/help_panel_overlay.py (lines 26-30) only lists 3 items:

_GLOBAL_ITEMS = (
    ("ctrl+q", "Quit TUI immediately"),
    ("F1", "Toggle help panel"),
    ("escape", "Close current overlay / return to prompt"),
)

The _CONTEXT_ITEMS["Main Screen"] (lines 33-39) only lists 5 items:

"Main Screen": (
    ("enter", "Submit prompt"),
    ("ctrl+t", "Cycle to next argument preset"),  # ← wrong key (should be ctrl+tab)
    ("@", "Open Reference Picker overlay"),
    ("/", "Open Slash Command overlay"),
    ("! / $", "Activate shell mode"),
),

Missing from global: ctrl+c, F2/ctrl+,, ctrl+s, ctrl+n, ctrl+w, ctrl+[/ctrl+], shift+tab
Missing from Main Screen: tab (persona cycling), ctrl+tab (preset cycling — listed as ctrl+t which is wrong), up/down history, backspace shell exit, ctrl+b sidebar focus

Steps to Reproduce

Run agents tui
Press F1
Observe: help panel shows only 3 global hotkeys and 5 context hotkeys
Many spec-required hotkeys are absent

Code Location

src/cleveragents/tui/widgets/help_panel_overlay.py lines 26-55

Impact

Users consulting the help panel will not find the complete hotkey reference. The help panel is incomplete and lists ctrl+t instead of the spec-required ctrl+tab for preset cycling.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** TUI — Help Panel (F1) / Hotkey Reference **Severity:** Low (documentation gap) ### What Was Tested The help panel content as defined in the specification (§ Help Panel (F1), §Hotkey Reference). ### Expected Behavior (from spec) The `F1` help panel should show context-sensitive hotkeys. For the Main Screen, the spec defines these hotkeys: **Global:** - `ctrl+q` — Quit TUI immediately - `ctrl+c` — Interrupt actor / double-tap to quit - `F1` — Toggle help panel - `F2` / `ctrl+,` — Open settings - `ctrl+s` — Open Sessions screen - `ctrl+n` — Create new session tab - `ctrl+w` — Close current session tab - `ctrl+[` / `ctrl+]` — Switch to previous / next session tab - `shift+tab` — Cycle sidebar: hidden → visible → fullscreen - `escape` — Close current overlay / modal / sidebar **MainScreen — Prompt Focused:** - `tab` — Cycle to next persona - `ctrl+tab` — Cycle to next argument preset - `up` (at row 0) — Previous prompt history entry - `down` (at last row) — Next prompt history entry - `@` — Open Reference Picker overlay - `/` (at position 0) — Open Slash Command overlay - `!` or `$` (at position 0) — Activate shell mode - `backspace` (at position 0 in shell mode) — Deactivate shell mode - `ctrl+b` — Focus sidebar (when visible) ### Actual Behavior (from code analysis) The `_GLOBAL_ITEMS` in `src/cleveragents/tui/widgets/help_panel_overlay.py` (lines 26-30) only lists 3 items: ```python _GLOBAL_ITEMS = ( ("ctrl+q", "Quit TUI immediately"), ("F1", "Toggle help panel"), ("escape", "Close current overlay / return to prompt"), ) ``` The `_CONTEXT_ITEMS["Main Screen"]` (lines 33-39) only lists 5 items: ```python "Main Screen": ( ("enter", "Submit prompt"), ("ctrl+t", "Cycle to next argument preset"), # ← wrong key (should be ctrl+tab) ("@", "Open Reference Picker overlay"), ("/", "Open Slash Command overlay"), ("! / $", "Activate shell mode"), ), ``` Missing from global: `ctrl+c`, `F2`/`ctrl+,`, `ctrl+s`, `ctrl+n`, `ctrl+w`, `ctrl+[`/`ctrl+]`, `shift+tab` Missing from Main Screen: `tab` (persona cycling), `ctrl+tab` (preset cycling — listed as `ctrl+t` which is wrong), `up`/`down` history, `backspace` shell exit, `ctrl+b` sidebar focus ### Steps to Reproduce 1. Run `agents tui` 2. Press `F1` 3. Observe: help panel shows only 3 global hotkeys and 5 context hotkeys 4. Many spec-required hotkeys are absent ### Code Location - `src/cleveragents/tui/widgets/help_panel_overlay.py` lines 26-55 ### Impact Users consulting the help panel will not find the complete hotkey reference. The help panel is incomplete and lists `ctrl+t` instead of the spec-required `ctrl+tab` for preset cycling. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 commented

2026-04-09 00:56:16 +00:00

Author

Owner

Closing as duplicate of #4789 — both issues report the same problem: TUI help panel missing spec-required hotkeys.

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Closing as duplicate of #4789 — both issues report the same problem: TUI help panel missing spec-required hotkeys. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 closed this issue

2026-04-09 00:56:16 +00:00

HAL9000 referenced this issue

2026-04-09 00:58:39 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 5) #5088