cleveragents/cleveragents-core

Fork 3

UAT: TUI multi-session tabs not implemented — only single hardcoded session supported #4638

New issue

Closed

opened 2026-04-08 17:40:40 +00:00 by HAL9000 · 2 comments

HAL9000 commented

2026-04-08 17:40:40 +00:00

Owner

Bug Report

Feature Area: TUI plan monitoring and live updates (v3.7.0 TUI)
Severity: Medium — missing multi-session management
Found by: UAT tester instance uat-tester-worker-tui-plan-monitoring

What Was Tested

Code-level analysis of src/cleveragents/tui/app.py against the specification section "Session Tabs" (spec lines 29761–29773) and "MainScreen Layout" (spec lines 29031–29086).

Expected Behavior (from spec)

The spec (lines 29761–29773) defines a Session Tabs bar:

┌────────────────────────────────────────────────────────────────────────────┐
│ Session 1  ┃ Session 2 ┃  Session 3  ┃  ⌛ Session 4                       │
│              ┗━━━━━━━━━┛                                                   │
│                                                                            │
│ ctrl+[  Previous │ ctrl+]  Next │ ctrl+n  New │ ctrl+w  Close             │
│ ctrl+s  Sessions screen │ 1-9  Jump to tab                                 │
│                                                                            │
│ Indicators:  ⌛ actor working  │  ❯ awaiting input  │  (plain) idle        │
│              ━━━ active tab underline                                       │
└────────────────────────────────────────────────────────────────────────────┘

Required features:

Tab bar showing all sessions with state indicators (⌛, ❯, plain)
Active tab underline indicator
ctrl+[ / ctrl+] to switch sessions
ctrl+n to create new session
ctrl+w to close current session
ctrl+s to open Sessions screen
1–9 to jump to tab by index
Tab bar hidden when only one session exists

Actual Behavior (from code analysis)

src/cleveragents/tui/app.py:

def __init__(self, ...) -> None:
    ...
    self._session = SessionView(session_id="default", transcript=[])

Single hardcoded session "default" — no session list, no tab bar
No session tab widget in compose() or anywhere in src/cleveragents/tui/
Missing bindings: ctrl+[, ctrl+], ctrl+n, ctrl+w, ctrl+s — none registered in BINDINGS
The SessionView dataclass (lines 55–60) is minimal: only session_id and transcript
TuiCommandRouter._session_command() only handles show, export, import — no create, close, switch, list

Code Locations

src/cleveragents/tui/app.py lines 92–96 (BINDINGS), 107 (_session init)
src/cleveragents/tui/commands.py lines 106–113 (_session_command)
src/cleveragents/tui/widgets/ — no session tab widget

Impact

Users cannot:

Run multiple independent sessions simultaneously
Monitor different plans in separate sessions
Switch between sessions with keyboard shortcuts
See session state indicators (working/awaiting/idle)

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

## Bug Report **Feature Area:** TUI plan monitoring and live updates (v3.7.0 TUI) **Severity:** Medium — missing multi-session management **Found by:** UAT tester instance `uat-tester-worker-tui-plan-monitoring` --- ### What Was Tested Code-level analysis of `src/cleveragents/tui/app.py` against the specification section **"Session Tabs"** (spec lines 29761–29773) and **"MainScreen Layout"** (spec lines 29031–29086). --- ### Expected Behavior (from spec) The spec (lines 29761–29773) defines a **Session Tabs** bar: ``` ┌────────────────────────────────────────────────────────────────────────────┐ │ Session 1 ┃ Session 2 ┃ Session 3 ┃ ⌛ Session 4 │ │ ┗━━━━━━━━━┛ │ │ │ │ ctrl+[ Previous │ ctrl+] Next │ ctrl+n New │ ctrl+w Close │ │ ctrl+s Sessions screen │ 1-9 Jump to tab │ │ │ │ Indicators: ⌛ actor working │ ❯ awaiting input │ (plain) idle │ │ ━━━ active tab underline │ └────────────────────────────────────────────────────────────────────────────┘ ``` Required features: - Tab bar showing all sessions with state indicators (`⌛`, `❯`, plain) - Active tab underline indicator - `ctrl+[` / `ctrl+]` to switch sessions - `ctrl+n` to create new session - `ctrl+w` to close current session - `ctrl+s` to open Sessions screen - `1`–`9` to jump to tab by index - Tab bar hidden when only one session exists --- ### Actual Behavior (from code analysis) `src/cleveragents/tui/app.py`: ```python def __init__(self, ...) -> None: ... self._session = SessionView(session_id="default", transcript=[]) ``` - **Single hardcoded session** `"default"` — no session list, no tab bar - **No session tab widget** in `compose()` or anywhere in `src/cleveragents/tui/` - **Missing bindings**: `ctrl+[`, `ctrl+]`, `ctrl+n`, `ctrl+w`, `ctrl+s` — none registered in `BINDINGS` - The `SessionView` dataclass (lines 55–60) is minimal: only `session_id` and `transcript` - `TuiCommandRouter._session_command()` only handles `show`, `export`, `import` — no `create`, `close`, `switch`, `list` --- ### Code Locations - `src/cleveragents/tui/app.py` lines 92–96 (`BINDINGS`), 107 (`_session` init) - `src/cleveragents/tui/commands.py` lines 106–113 (`_session_command`) - `src/cleveragents/tui/widgets/` — no session tab widget --- ### Impact Users cannot: - Run multiple independent sessions simultaneously - Monitor different plans in separate sessions - Switch between sessions with keyboard shortcuts - See session state indicators (working/awaiting/idle) --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added this to the v3.7.0 milestone

2026-04-08 17:53:57 +00:00

HAL9000 commented

2026-04-08 19:49:16 +00:00

Author

Owner

⚠️ Potential duplicate detected.

This issue appears to cover similar ground as:

#4776 — TUI multi-session tab bar not implemented (more detailed, newer)
#4656 — TUI multi-session tabs not implemented (similar scope)
#4389 — TUI multi-session tabs not implemented (older)
#4070 — TUI multi-session tabs completely absent (older)

These issues all track the same underlying missing feature. Consider consolidating into a single tracking issue to avoid duplicate implementation work.

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

⚠️ **Potential duplicate detected.** This issue appears to cover similar ground as: - #4776 — TUI multi-session tab bar not implemented (more detailed, newer) - #4656 — TUI multi-session tabs not implemented (similar scope) - #4389 — TUI multi-session tabs not implemented (older) - #4070 — TUI multi-session tabs completely absent (older) These issues all track the same underlying missing feature. Consider consolidating into a single tracking issue to avoid duplicate implementation work. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 referenced this issue

2026-04-08 19:49:18 +00:00

UAT: TUI multi-session tabs not implemented — only single hardcoded session exists #4389

HAL9000 referenced this issue

2026-04-08 19:55:50 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

freemo added the

labels

2026-04-08 23:40:51 +00:00

HAL9000 commented

2026-04-09 00:20:32 +00:00

Author

Owner

Closing as duplicate of #4656 — both issues report the same problem: TUI multi-session tabs not implemented. Issue #4656 has milestone v3.7.0 and story points (8) assigned.

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

Closing as duplicate of #4656 — both issues report the same problem: TUI multi-session tabs not implemented. Issue #4656 has milestone v3.7.0 and story points (8) assigned. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 closed this issue

2026-04-09 00:20:35 +00:00

HAL9000 referenced this issue

2026-04-09 00:48:37 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 4) #5017