gemini-cli-hud — A real-time bottom-sticky HUD for Gemini CLI

[yideng-xl]

Hey everyone! I built a HUD extension for Gemini CLI that displays a sticky status bar at the bottom of your terminal.

What it shows

• Active model (e.g., gemini-3-flash-preview)
• Context window usage with progress bar
• Tool calls in Claude-HUD style: ✓ Read ×8 | ✓ Bash ×4
• Loaded GEMINI.md file count
• Installed extensions count
• Currently active skill
• Session elapsed time

How it works

A background daemon tracks state via hook events (SessionStart, AfterModel, AfterTool). The hook process renders the HUD synchronously using DECSTBM scroll regions —
no race conditions with Ink.

The layout is responsive: on narrow terminals, modules wrap to the next line as a whole unit instead of breaking mid-text.

Install

gemini extensions install https://github.com/yideng-xl/gemini-cli-hud                                                                                               
                                                                                                  
No build step needed — just install and restart Gemini CLI.
                                                                                                                                                                      
Repo                                   
                                                                                                                                                                      
https://github.com/yideng-xl/gemini-cli-hud                                                                                                                           
                                                                                                  
Feedback, issues, and PRs are very welcome! Especially if you know a better way to render a sticky bottom bar without conflicting with Ink 😄