UAT: TUI critical hotkeys missing — tab (persona), shift+tab (sidebar), ctrl+s, ctrl+n, ctrl+w, ctrl+[/], alt+up/down #4398

New issue

Closed

opened 2026-04-08 12:06:48 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 12:06:48 +00:00

Owner

Bug Report

Feature Area: TUI — Hotkeys / Key Bindings

What Was Tested

The spec defines a comprehensive set of hotkeys for the TUI. The footer bar should always show context-sensitive hotkey references.

Expected Behavior (from spec)

Footer bar hotkeys (always visible):

F1 Help │ shift+tab Sidebar │ tab Persona │ ctrl+tab Preset │ ctrl+s Sessions │ ctrl+q Quit

Complete required hotkeys:

Key	Action	Status
`ctrl+q`	Quit	✅ Implemented
`f1`	Help	✅ Implemented
`ctrl+t`	Cycle Preset	✅ Implemented (as `ctrl+t` instead of `ctrl+tab`)
`tab`	Cycle to next persona	❌ Missing
`shift+tab`	Cycle sidebar: hidden → visible → fullscreen	❌ Missing
`ctrl+s`	Open Sessions screen	❌ Missing
`ctrl+n`	New session tab	❌ Missing
`ctrl+w`	Close current session tab	❌ Missing
`ctrl+[`	Previous session tab	❌ Missing
`ctrl+]`	Next session tab	❌ Missing
`alt+up`	Move block cursor up	❌ Missing
`alt+down`	Move block cursor down	❌ Missing
`ctrl+r`	Resume saved session (from SessionsScreen)	❌ Missing
`ctrl+b`	Focus sidebar	❌ Missing
`ctrl+p`	Create Persona (from fullscreen sidebar)	❌ Missing
`f2` / `ctrl+,`	Open Settings screen	❌ Missing
`1-9`	Jump to session tab by number	❌ Missing
`escape`	Cascade toward main screen	❌ Missing (no cascade logic)

Note: The spec uses ctrl+tab for preset cycling, but the implementation uses ctrl+t. This is a deviation from the spec.

Actual Behavior

The BINDINGS in src/cleveragents/tui/app.py only contains:

BINDINGS = [
    ("ctrl+q", "quit", "Quit"),
    ("f1", "help", "Help"),
    ("ctrl+t", "cycle_preset", "Cycle Preset"),  # Should be ctrl+tab per spec
]

The footer bar shows these 3 bindings only. The spec requires at least 15+ bindings.

Code Location

src/cleveragents/tui/app.py — BINDINGS class variable
Spec reference: §"TUI Architecture Overview" footer bar (line ~29077), §"Session Tabs" (line ~29768)

Impact

Most TUI navigation is keyboard-inaccessible. The spec states "Keyboard-first — every operation achievable without a mouse; mouse is supplementary" — this principle is violated.

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

## Bug Report **Feature Area:** TUI — Hotkeys / Key Bindings ### What Was Tested The spec defines a comprehensive set of hotkeys for the TUI. The footer bar should always show context-sensitive hotkey references. ### Expected Behavior (from spec) **Footer bar hotkeys (always visible):** ``` F1 Help │ shift+tab Sidebar │ tab Persona │ ctrl+tab Preset │ ctrl+s Sessions │ ctrl+q Quit ``` **Complete required hotkeys:** | Key | Action | Status | |-----|--------|--------| | `ctrl+q` | Quit | ✅ Implemented | | `f1` | Help | ✅ Implemented | | `ctrl+t` | Cycle Preset | ✅ Implemented (as `ctrl+t` instead of `ctrl+tab`) | | `tab` | Cycle to next persona | ❌ Missing | | `shift+tab` | Cycle sidebar: hidden → visible → fullscreen | ❌ Missing | | `ctrl+s` | Open Sessions screen | ❌ Missing | | `ctrl+n` | New session tab | ❌ Missing | | `ctrl+w` | Close current session tab | ❌ Missing | | `ctrl+[` | Previous session tab | ❌ Missing | | `ctrl+]` | Next session tab | ❌ Missing | | `alt+up` | Move block cursor up | ❌ Missing | | `alt+down` | Move block cursor down | ❌ Missing | | `ctrl+r` | Resume saved session (from SessionsScreen) | ❌ Missing | | `ctrl+b` | Focus sidebar | ❌ Missing | | `ctrl+p` | Create Persona (from fullscreen sidebar) | ❌ Missing | | `f2` / `ctrl+,` | Open Settings screen | ❌ Missing | | `1-9` | Jump to session tab by number | ❌ Missing | | `escape` | Cascade toward main screen | ❌ Missing (no cascade logic) | **Note:** The spec uses `ctrl+tab` for preset cycling, but the implementation uses `ctrl+t`. This is a deviation from the spec. ### Actual Behavior The `BINDINGS` in `src/cleveragents/tui/app.py` only contains: ```python BINDINGS = [ ("ctrl+q", "quit", "Quit"), ("f1", "help", "Help"), ("ctrl+t", "cycle_preset", "Cycle Preset"), # Should be ctrl+tab per spec ] ``` The footer bar shows these 3 bindings only. The spec requires at least 15+ bindings. ### Code Location - `src/cleveragents/tui/app.py` — `BINDINGS` class variable - Spec reference: §"TUI Architecture Overview" footer bar (line ~29077), §"Session Tabs" (line ~29768) ### Impact Most TUI navigation is keyboard-inaccessible. The spec states "Keyboard-first — every operation achievable without a mouse; mouse is supplementary" — this principle is violated. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 14:29:45 +00:00

UAT: TUI app.py missing required hotkey bindings — tab (persona cycle), shift+tab (sidebar), ctrl+s (sessions), ctrl+n (new session), ctrl+w (close session), ctrl+[ / ctrl+] (session tabs), F2/ctrl+, (settings) #4513

HAL9000 added this to the v3.7.0 milestone

2026-04-08 17:42:37 +00:00

HAL9000 commented

2026-04-09 01:28:26 +00:00

Author

Owner

Closing as duplicate of #4789 — TUI help panel missing spec-required hotkeys.

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

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

HAL9000 closed this issue

2026-04-09 01:28:26 +00:00

HAL9000 referenced this issue

2026-04-09 01:30:08 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 9) #5135