mirror of https://github.com/google-gemini/gemini-cli.git synced 2026-03-21 11:30:38 -07:00

Files

Keith Guerin 22cf2a6e91 feat(ui): implement refreshed UX for Composer layout

- Promotes refreshed multi-row status area and footer as the default experience.
- Stabilizes Composer row heights to prevent layout 'jitter' during typing and model turns.
- Unifies active hook status and model loading indicators into a single, stable Row 1.
- Refactors settings to use backward-compatible 'Hide' booleans (ui.hideStatusTips, ui.hideStatusWit).
- Removes vestigial context usage bleed-through logic in minimal mode to align with global UX direction.
- Relocates toast notifications to the top status row for improved visibility.
- Updates all CLI UI snapshots and architectural tests to reflect the stabilized layout.
- Fixes persistent TypeScript compilation errors in tests by refactoring async render helpers (`LoadingIndicator.test.tsx`, `AppHeader.test.tsx`, `ToolMessage.test.tsx`) to avoid direct destructuring of complex inferred return types, ensuring consistent Promise flattening across all CI environments (Node 20/22/24).

2026-03-19 23:21:20 -07:00

1.9 KiB

Raw Blame History

Notifications (experimental)

Gemini CLI can send system notifications to alert you when a session completes or when it needs your attention, such as when it's waiting for you to approve a tool call.

Note: This is a preview feature currently under active development. Preview features may be available on the Preview channel or may need to be enabled under /settings.

Notifications are particularly useful when running long-running tasks or using Plan Mode, letting you switch to other windows while Gemini CLI works in the background.

Requirements

Currently, system notifications are only supported on macOS.

Terminal support

The CLI uses the OSC 9 terminal escape sequence to trigger system notifications. This is supported by several modern terminal emulators. If your terminal does not support OSC 9 notifications, Gemini CLI falls back to a system alert sound to get your attention.

Enable notifications

Notifications are disabled by default. You can enable them using the /settings command or by updating your settings.json file.

Open the settings dialog by typing /settings in an interactive session.
Navigate to the General category.
Toggle the Enable Notifications setting to On.

Alternatively, add the following to your settings.json:

{
  "general": {
    "enableNotifications": true
  }
}

Types of notifications

Gemini CLI sends notifications for the following events:

Action required: Triggered when the model is waiting for user input or tool approval. This helps you know when the CLI has paused and needs you to intervene.
Session complete: Triggered when a session finishes successfully. This is useful for tracking the completion of automated tasks.

Next steps

Start planning with Plan Mode.
Configure your experience with other settings.

1.9 KiB Raw Blame History