Skip to content

fix(cli): harden TUI flicker and streaming output stability #3663

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
chiga0 wants to merge 17 commits into from
Closed

fix(cli): harden TUI flicker and streaming output stability #3663

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
231df26
fix(cli): bound streaming TUI output height
Apr 27, 2026
43f128b
fix(cli): harden TUI flicker regressions
Apr 27, 2026
3d70d75
fix(cli): repaint static viewport on resize
Apr 27, 2026
54cca31
fix(cli): close narrow streaming clear gap
Apr 27, 2026
0d22f52
test(cli): add shell reflow evidence
Apr 27, 2026
6633032
fix(cli): avoid false tool overflow and static refresh clears
Apr 28, 2026
36fb89d
fix(cli): reduce shell and tmux redraw pressure
Apr 28, 2026
c27d9b9
test(cli): cover remaining refresh and redraw guards
Apr 28, 2026
369e1ec
fix(cli): stabilize narrow markdown streaming
Apr 28, 2026
4983615
fix(cli): keep pending markdown plain to prevent narrow scrollback du…
Apr 28, 2026
992de1c
fix(cli): hard-bound narrow pending markdown
Apr 28, 2026
314cf2f
fix(cli): cap pending markdown live viewport
Apr 28, 2026
53a0b48
fix(cli): suppress pending markdown scrollback artifacts
Apr 28, 2026
6c6bcf5
fix(cli): trim blank streaming tails from live preview
Apr 29, 2026
c7d5013
fix(core): normalize cumulative openai stream deltas
Apr 29, 2026
2058c43
test(tui): add duplicate stream diagnostics
Apr 29, 2026
242f4b5
fix(cli): stabilize narrow streaming output and waiting state
May 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 15 additions & 15 deletions docs/design/compact-mode/compact-mode-design.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -116,22 +116,22 @@ Qwen Code uses a **component-level rendering flag** that each UI component reads

### 3.2 Key Source Files

| Component | File | Key Logic |
| --------------- | ------------------------------------- | ----------------------------------------------- |
| Toggle handler | `AppContainer.tsx:1684-1690` | Toggles `compactMode`, persists to settings |
| Context | `CompactModeContext.tsx` | `compactMode`, `setCompactMode` |
| Tool group | `ToolGroupMessage.tsx:105-110` | `showCompact` with 4 force-expand conditions |
| Tool message | `ToolMessage.tsx:346-350` | Hides `displayRenderer` in compact mode |
| Compact display | `CompactToolGroupDisplay.tsx:49-108` | Single-line summary with status + hint |
| Confirmation | `ToolConfirmationMessage.tsx:113-147` | Simplified 3-option compact approval |
| Tips | `Tips.tsx:14-29` | Startup tip rotation includes compact mode hint |
| Settings sync | `SettingsDialog.tsx:189-193` | Syncs with CompactModeContext + refreshStatic |
| MainContent | `MainContent.tsx:60-76` | Renders live pendingHistoryItems |
| Thinking | `HistoryItemDisplay.tsx:123-133` | Hides `gemini_thought` in compact mode |
| Component | File | Key Logic |
| --------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Toggle handler | `AppContainer.tsx:1684-1690` | Toggles `compactMode`, persists to settings |
| Context | `CompactModeContext.tsx` | `compactMode`, `setCompactMode` |
| Tool group | `ToolGroupMessage.tsx:105-110` | `showCompact` with 4 force-expand conditions |
| Tool message | `ToolMessage.tsx:346-350` | Hides `displayRenderer` in compact mode |
| Compact display | `CompactToolGroupDisplay.tsx:49-108` | Single-line summary with status + hint |
| Confirmation | `ToolConfirmationMessage.tsx:113-147` | Simplified 3-option compact approval |
| Tips | `Tips.tsx:14-29` | Startup tip rotation includes compact mode hint |
| Settings sync | `SettingsDialog.tsx:189-193` | Syncs with CompactModeContext + refreshStatic |
| MainContent | `MainContent.tsx:60-76` | Renders live pendingHistoryItems |
| Thinking | `HistoryItemDisplay.tsx` | Hides `gemini_thought` by default unless `ui.inlineThinkingMode` is `full`; compact mode still hides it |

### 3.3 Design Decisions

1. **Verbose is the default.** Users see all tool output and thinking by default.
1. **Tool output remains verbose by default.** Streamed thinking is status-only by default to avoid narrow-terminal scrollback repeats; users can restore inline thinking with `ui.inlineThinkingMode: "full"`.
2. **Persistent preference.** `compactMode` is saved to `settings.json` and survives across sessions.
3. **Component-level rendering.** Each component reads `compactMode` from context and adjusts its own rendering.
4. **Force-expand protection.** Four conditions override compact mode to ensure critical UI elements are always visible (confirmations, errors, shell, user-initiated).
Expand All @@ -144,7 +144,7 @@ Qwen Code uses a **component-level rendering flag** that each UI component reads
```
Session start → verbose mode (default)
│
├─ All tool outputs, thinking, details visible
├─ All tool outputs and details visible; thinking stays in live status
│
├─ User presses Ctrl+O (or toggles in Settings)
│ └─→ compactMode = true, persisted
Expand All @@ -154,7 +154,7 @@ Session start → verbose mode (default)
│
├─ User presses Ctrl+O again
│ └─→ compactMode = false, persisted
│ └─ All details visible again
│ └─ All details visible again; inline thinking follows ui.inlineThinkingMode
│
└─ Next session → same mode as last session
```
Expand Down
Loading