mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-05-24 10:42:37 -07:00
Keith Guerin
80 lines
2.6 KiB
Markdown
80 lines
2.6 KiB
Markdown
# Layout Refinement: Unified Session State & Composer Organization
|
|
|
|
## Goal
|
|
|
|
The objective is to consolidate all persistent "Session Modes" into a single,
|
|
unified status area in the footer and reorganize the remaining transient
|
|
elements in the Composer for a cleaner information hierarchy.
|
|
|
|
## Phase 1: Unified Footer Modes
|
|
|
|
The footer's first column is expanded to be the **Unified Mode Indicator**. It
|
|
natively incorporates the three primary state toggles of the application.
|
|
|
|
- **Approval Mode:** (manual, auto-accept, plan, YOLO) - Always visible.
|
|
- **Shell Mode:** Visible only when active.
|
|
- **Raw Markdown Mode:** Visible only when active.
|
|
|
|
### Footer Layout
|
|
|
|
- **Header:** `mode (Shift+Tab)`
|
|
- **Data Row:** Multiple modes are displayed in their respective semantic
|
|
colors, separated by a middle dot (`·`).
|
|
- **Example:** `plan · shell · raw`
|
|
|
|
## Phase 2: Composer Cleanup & Swap
|
|
|
|
With all modes moved to the footer, the Composer is simplified to handle only
|
|
transient notifications and active processing states. These two areas are
|
|
swapped across the horizontal divider.
|
|
|
|
### 1. The "Above Divider" Zone (Environment Alerts)
|
|
|
|
Reserved for transient notifications that alert the user to environment-level
|
|
changes.
|
|
|
|
- **Toast Messages:** (e.g., "Press Ctrl+C again to exit")
|
|
- **Shortcuts Hint:** (e.g., "? for shortcuts") - Remains flush right.
|
|
|
|
### 2. The "Below Divider" Zone (Active processing)
|
|
|
|
Reserved exclusively for the application's current activity. It sits directly
|
|
above the input prompt for maximum visibility during streaming.
|
|
|
|
- **Loading Indicator:** (e.g., "Thinking...", "Executing Hooks")
|
|
- **Status Display:** (Context usage summary)
|
|
|
|
## Target Layout Mockup
|
|
|
|
### Composer Area
|
|
|
|
```text
|
|
[ConfigInitDisplay]
|
|
[QueuedMessageDisplay]
|
|
[TodoTray]
|
|
|
|
[ToastDisplay] [ShortcutsHint]
|
|
----------------------------------------------------------------------
|
|
[LoadingIndicator (e.g., Thinking...)]
|
|
[StatusDisplay]
|
|
|
|
[InputPrompt]
|
|
```
|
|
|
|
### Footer Area (Status Line)
|
|
|
|
```text
|
|
mode (Shift+Tab) workspace /model
|
|
manual · shell · raw ~/src/gemini-cli gemini-pro
|
|
```
|
|
|
|
## Key Principles
|
|
|
|
- **Single Source of Truth:** All "modes" now live in the footer. If a user
|
|
wants to know what state the CLI is in, they only need to look at the far-left
|
|
footer item.
|
|
- **Reduced Jitter:** Moving the Shell and Markdown indicators out of the
|
|
Composer reduces vertical jumping in the main interaction area.
|
|
- **Immediate Feedback:** The Loading Indicator remains closest to the Input
|
|
Prompt, providing the most direct feedback during generation.
|