UAT: ui.sessions_bar TUI setting not implemented — tab bar visibility cannot be configured #1386

New issue

Open

opened 2026-04-02 17:02:25 +00:00 by freemo · 0 comments

freemo commented

2026-04-02 17:02:25 +00:00

Owner

Bug Report

Feature Area: Multi-session tabs — settings
Severity: Medium
Found by: UAT tester instance uat-worker-tabs

Expected Behavior (from spec §Complete Settings Schema)

The specification (docs/specification.md, line ~30042) defines a ui.sessions_bar setting:

Setting	Type	Default	Range / Choices	Description
`ui.sessions_bar`	choices	`multiple`	`always` / `multiple` / `never`	When to show the session tab bar (`multiple` = only when ≥2 sessions)

This setting controls the visibility behavior of the session tab bar:

always — always show the tab bar, even with a single session
multiple — show the tab bar only when there are 2 or more sessions (default)
never — never show the tab bar

The spec also states (line ~28911): "Hidden when only one session exists" — which corresponds to the multiple default.

Actual Behavior

No TUI settings system exists in the codebase. A search confirms:

$ grep -rn "ui.sessions_bar\|sessions_bar\|tui.settings\|tui-settings\|TuiSettings\|SettingsScreen" src/cleveragents/tui/
(no results)

There is no:

Settings schema or dataclass
Settings persistence (the spec requires ~/.config/cleveragents/tui-settings.json)
Settings Screen (F2 / ctrl+,)
ui.sessions_bar setting implementation
Logic to conditionally show/hide the tab bar based on session count

Steps to Reproduce

Search src/cleveragents/tui/ for sessions_bar, TuiSettings, SettingsScreen
Observe: no settings system exists

Code Location

src/cleveragents/tui/ — no settings module, no settings_screen.py
src/cleveragents/tui/app.py — no reference to ui.sessions_bar or settings loading

Impact

The tab bar visibility cannot be configured. The default behavior (hide when single session) cannot be enforced programmatically since neither the setting nor the tab bar widget exists. Users who want the tab bar always visible or always hidden have no way to configure this.

Note: This bug is related to but distinct from issue #1374 (tab bar widget not implemented). Even once the tab bar widget is implemented, the ui.sessions_bar setting must also be implemented to control its visibility.

## Bug Report **Feature Area:** Multi-session tabs — settings **Severity:** Medium **Found by:** UAT tester instance `uat-worker-tabs` --- ### Expected Behavior (from spec §Complete Settings Schema) The specification (docs/specification.md, line ~30042) defines a `ui.sessions_bar` setting: | Setting | Type | Default | Range / Choices | Description | |---------|------|---------|----------------|-------------| | `ui.sessions_bar` | choices | `multiple` | `always` / `multiple` / `never` | When to show the session tab bar (`multiple` = only when ≥2 sessions) | This setting controls the visibility behavior of the session tab bar: - `always` — always show the tab bar, even with a single session - `multiple` — show the tab bar only when there are 2 or more sessions (default) - `never` — never show the tab bar The spec also states (line ~28911): "Hidden when only one session exists" — which corresponds to the `multiple` default. --- ### Actual Behavior No TUI settings system exists in the codebase. A search confirms: ``` $ grep -rn "ui.sessions_bar\|sessions_bar\|tui.settings\|tui-settings\|TuiSettings\|SettingsScreen" src/cleveragents/tui/ (no results) ``` There is no: - Settings schema or dataclass - Settings persistence (the spec requires `~/.config/cleveragents/tui-settings.json`) - Settings Screen (`F2` / `ctrl+,`) - `ui.sessions_bar` setting implementation - Logic to conditionally show/hide the tab bar based on session count --- ### Steps to Reproduce 1. Search `src/cleveragents/tui/` for `sessions_bar`, `TuiSettings`, `SettingsScreen` 2. Observe: no settings system exists --- ### Code Location - `src/cleveragents/tui/` — no settings module, no `settings_screen.py` - `src/cleveragents/tui/app.py` — no reference to `ui.sessions_bar` or settings loading --- ### Impact The tab bar visibility cannot be configured. The default behavior (hide when single session) cannot be enforced programmatically since neither the setting nor the tab bar widget exists. Users who want the tab bar always visible or always hidden have no way to configure this. Note: This bug is related to but distinct from issue #1374 (tab bar widget not implemented). Even once the tab bar widget is implemented, the `ui.sessions_bar` setting must also be implemented to control its visibility.

freemo added the

labels

2026-04-02 17:53:40 +00:00

freemo self-assigned this

2026-04-02 18:45:15 +00:00

freemo removed the