UAT: TUI Settings Screen not implemented — F2 and ctrl+, have no effect #5042

Closed
opened 2026-04-09 00:50:26 +00:00 by HAL9000 · 1 comment
Owner

Bug Report

Feature Area: TUI — Settings Screen

Severity: High (settings management missing)

What Was Tested

The Settings Screen as defined in the specification (§ Settings Screen, §Complete Settings Schema).

Expected Behavior (from spec)

The Settings screen (F2 or ctrl+,) is a modal overlay with search-driven navigation through all TUI settings. It includes:

  • A search input (ctrl+s to focus) for filtering settings
  • Collapsible setting groups: UI, Notifications, Sidebar, Agent, Tools, Shell, Diff
  • Each setting shows: name, current value in brackets, description
  • Settings are schema-driven and auto-generated from the schema
  • Settings are persisted as JSON in ~/.config/cleveragents/tui-settings.json
  • Auto-saves when dismissed

The complete settings schema includes 20+ settings across 7 groups (ui., notifications., sidebar., agent., tools., shell., diff.*).

Hotkeys:

  • ctrl+s — Focus search input
  • tab/shift+tab — Navigate settings fields
  • enter — Edit the focused setting
  • esc — Close settings (auto-saves)

Actual Behavior (from code analysis)

The BINDINGS in src/cleveragents/tui/app.py do not include F2 or ctrl+,. No SettingsScreen widget or screen class exists anywhere in the TUI codebase. The screens/ directory is empty.

The /settings slash command is listed in SLASH_COMMAND_SPECS (line 84 of slash_catalog.py) but the TuiCommandRouter.handle() method returns "Unknown command: /settings" for it (line 58 of commands.py).

Steps to Reproduce

  1. Run agents tui
  2. Press F2 — nothing happens
  3. Press ctrl+, — nothing happens
  4. Type /settings and press Enter — returns "Unknown command: /settings"

Code Location

  • src/cleveragents/tui/app.py lines 92-96 (BINDINGS — F2, ctrl+, absent)
  • src/cleveragents/tui/commands.py line 58 (returns "Unknown command" for settings)
  • src/cleveragents/tui/screens/ — empty directory

Impact

Users cannot:

  • Change the TUI theme
  • Configure notification behavior
  • Adjust sidebar width
  • Change tool expand behavior
  • Modify any TUI settings

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

## Bug Report **Feature Area:** TUI — Settings Screen **Severity:** High (settings management missing) ### What Was Tested The Settings Screen as defined in the specification (§ Settings Screen, §Complete Settings Schema). ### Expected Behavior (from spec) The Settings screen (`F2` or `ctrl+,`) is a modal overlay with search-driven navigation through all TUI settings. It includes: - A search input (`ctrl+s` to focus) for filtering settings - Collapsible setting groups: UI, Notifications, Sidebar, Agent, Tools, Shell, Diff - Each setting shows: name, current value in brackets, description - Settings are schema-driven and auto-generated from the schema - Settings are persisted as JSON in `~/.config/cleveragents/tui-settings.json` - Auto-saves when dismissed The complete settings schema includes 20+ settings across 7 groups (ui.*, notifications.*, sidebar.*, agent.*, tools.*, shell.*, diff.*). Hotkeys: - `ctrl+s` — Focus search input - `tab`/`shift+tab` — Navigate settings fields - `enter` — Edit the focused setting - `esc` — Close settings (auto-saves) ### Actual Behavior (from code analysis) The `BINDINGS` in `src/cleveragents/tui/app.py` do not include `F2` or `ctrl+,`. No `SettingsScreen` widget or screen class exists anywhere in the TUI codebase. The `screens/` directory is empty. The `/settings` slash command is listed in `SLASH_COMMAND_SPECS` (line 84 of `slash_catalog.py`) but the `TuiCommandRouter.handle()` method returns `"Unknown command: /settings"` for it (line 58 of `commands.py`). ### Steps to Reproduce 1. Run `agents tui` 2. Press `F2` — nothing happens 3. Press `ctrl+,` — nothing happens 4. Type `/settings` and press Enter — returns "Unknown command: /settings" ### Code Location - `src/cleveragents/tui/app.py` lines 92-96 (BINDINGS — `F2`, `ctrl+,` absent) - `src/cleveragents/tui/commands.py` line 58 (returns "Unknown command" for settings) - `src/cleveragents/tui/screens/` — empty directory ### Impact Users cannot: - Change the TUI theme - Configure notification behavior - Adjust sidebar width - Change tool expand behavior - Modify any TUI settings --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester
Author
Owner

Closing as duplicate of #4759 — issue #4759 already tracks that TUI screens/ directory is empty, including SettingsScreen not being implemented.


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

Closing as duplicate of #4759 — issue #4759 already tracks that TUI screens/ directory is empty, including SettingsScreen not being implemented. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#5042
No description provided.