UAT: Settings screen modal not implemented — TUI has no settings UI accessible via Ctrl+, or menu #1371

New issue

Open

opened 2026-04-02 16:59:57 +00:00 by freemo · 0 comments

freemo commented

2026-04-02 16:59:57 +00:00

Owner

Bug Report

Feature Area: Settings Screen
Severity: Critical
Found by: UAT tester (uat-worker-settings)

Expected Behavior (from spec)

The specification states:

The Settings screen is a modal dialog accessible from the main application menu and via a keyboard shortcut (Ctrl+, on Windows/Linux, Cmd+, on macOS). It provides a centralized location for managing application-wide configuration.

The screen is organized into the following tabs:

General: Core application settings, including theme, default automation profile, and UI preferences.

Providers: Management of LLM provider credentials (API keys) and default model selections.

Actors: Default actor configurations for different phases (Strategize, Execute).

ACMS: Advanced Context Management System settings.

Shortcuts: Keyboard shortcut customization.

Server: Server connection settings (for server mode).

Actual Behavior

No settings screen/modal exists anywhere in the codebase. Specifically:

No SettingsScreen, SettingsModal, SettingsPanel, or any settings widget exists in src/cleveragents/tui/ or anywhere in the source tree.

The Ctrl+, keyboard binding is not registered in the TUI app. The only bindings defined in src/cleveragents/tui/app.py (line 90-94) are:

BINDINGS: ClassVar[list[tuple[str, str, str]]] = [
    ("ctrl+q", "quit", "Quit"),
    ("f1", "help", "Help"),
    ("ctrl+t", "cycle_preset", "Cycle Preset"),
]

The /settings slash command is listed in the catalog (src/cleveragents/tui/slash_catalog.py, line 84) but is not handled by TuiCommandRouter. When dispatched, it returns "Unknown command: /settings".
No action_settings() method exists in the TUI app class.

Steps to Reproduce

Run the TUI application
Press Ctrl+, — nothing happens (no settings modal opens)
Type /settings in the prompt — returns "Unknown command: /settings"

Code Locations

src/cleveragents/tui/app.py — BINDINGS list (lines 90-94), no action_settings method
src/cleveragents/tui/commands.py — TuiCommandRouter.handle() (lines 21-31), no settings handling
src/cleveragents/tui/slash_catalog.py — line 84, /settings listed but not implemented
No settings widget files exist under src/cleveragents/tui/widgets/

Impact

This is a critical missing feature. The Settings screen is the primary UI for all user configuration management. Without it, users cannot configure API keys, themes, actor defaults, ACMS settings, or keyboard shortcuts through the TUI.

## Bug Report **Feature Area:** Settings Screen **Severity:** Critical **Found by:** UAT tester (uat-worker-settings) ### Expected Behavior (from spec) The specification states: > The Settings screen is a modal dialog accessible from the main application menu and via a keyboard shortcut (`Ctrl+,` on Windows/Linux, `Cmd+,` on macOS). It provides a centralized location for managing application-wide configuration. > > The screen is organized into the following tabs: > - **General**: Core application settings, including theme, default automation profile, and UI preferences. > - **Providers**: Management of LLM provider credentials (API keys) and default model selections. > - **Actors**: Default actor configurations for different phases (Strategize, Execute). > - **ACMS**: Advanced Context Management System settings. > - **Shortcuts**: Keyboard shortcut customization. > - **Server**: Server connection settings (for server mode). ### Actual Behavior No settings screen/modal exists anywhere in the codebase. Specifically: 1. **No `SettingsScreen`, `SettingsModal`, `SettingsPanel`, or any settings widget** exists in `src/cleveragents/tui/` or anywhere in the source tree. 2. **The `Ctrl+,` keyboard binding is not registered** in the TUI app. The only bindings defined in `src/cleveragents/tui/app.py` (line 90-94) are: ```python BINDINGS: ClassVar[list[tuple[str, str, str]]] = [ ("ctrl+q", "quit", "Quit"), ("f1", "help", "Help"), ("ctrl+t", "cycle_preset", "Cycle Preset"), ] ``` 3. **The `/settings` slash command is listed in the catalog** (`src/cleveragents/tui/slash_catalog.py`, line 84) but is **not handled** by `TuiCommandRouter`. When dispatched, it returns `"Unknown command: /settings"`. 4. **No `action_settings()` method** exists in the TUI app class. ### Steps to Reproduce 1. Run the TUI application 2. Press `Ctrl+,` — nothing happens (no settings modal opens) 3. Type `/settings` in the prompt — returns "Unknown command: /settings" ### Code Locations - `src/cleveragents/tui/app.py` — BINDINGS list (lines 90-94), no `action_settings` method - `src/cleveragents/tui/commands.py` — `TuiCommandRouter.handle()` (lines 21-31), no settings handling - `src/cleveragents/tui/slash_catalog.py` — line 84, `/settings` listed but not implemented - No `settings` widget files exist under `src/cleveragents/tui/widgets/` ### Impact This is a critical missing feature. The Settings screen is the primary UI for all user configuration management. Without it, users cannot configure API keys, themes, actor defaults, ACMS settings, or keyboard shortcuts through the TUI.

Rows
Columns