Skip to content

feat(hooks): display hook system messages in UI#24616

Merged
mbleigh merged 7 commits intomainfrom
mb/hook-display
Apr 7, 2026
Merged

feat(hooks): display hook system messages in UI#24616
mbleigh merged 7 commits intomainfrom
mb/hook-display

Conversation

@mbleigh
Copy link
Copy Markdown
Contributor

@mbleigh mbleigh commented Apr 3, 2026

Summary

Introduces the ability for hooks to display system messages in the CLI UI. This is controlled by a new advanced setting hooksConfig.showOutput.

Details

  • Added hooksConfig.showOutput to settings schema and Config class.
  • Modified HookRunner to track the format of hook output (json vs text) in the HookExecutionResult.
  • Updated HookEventHandler to emit a hook-system-message event when a hook returns a systemMessage in JSON format and the setting is enabled.
  • Updated AppContainer in the CLI to listen for hook-system-message and add it to the chat history as an INFO message.
  • Enhanced InfoMessage component to optionally display the source (hook name) of the message.
  • Refactored HookExecutionResult to include outputFormat instead of adding it to the HookOutput interface.

Preview of hook content:

image

Related Issues

Related to hook extensibility and user feedback.

How to Validate

  1. Enable the setting: gemini config set hooksConfig.showOutput true
  2. Create a hook that returns JSON with a systemMessage, e.g., echo '{"decision": "allow", "systemMessage": "Hello from hook!"}'
  3. Run a command that triggers the hook.
  4. Observe the "Hello from hook! [hook-name]" message in the chat history.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed)
  • Noted breaking changes (if any)
  • Validated on MacOS
    • npm run

…etting

- Introduces a new `hooksConfig.showOutput` setting (default `false`).
- Parses JSON output from hooks to extract `systemMessage`.
- Emits a new `HookSystemMessage` event to the UI when a hook returns a system message and `showOutput` is enabled.
- Updates the React CLI app to listen for these events and render them inline in the chat history.
@mbleigh mbleigh requested review from a team as code owners April 3, 2026 16:28
@gemini-cli
Copy link
Copy Markdown
Contributor

gemini-cli bot commented Apr 3, 2026

Hi @mbleigh, thank you so much for your contribution to Gemini CLI! We really appreciate the time and effort you've put into this.

We're making some updates to our contribution process to improve how we track and review changes. Please take a moment to review our recent discussion post: Improving Our Contribution Process & Introducing New Guidelines.

Key Update: Starting January 26, 2026, the Gemini CLI project will require all pull requests to be associated with an existing issue. Any pull requests not linked to an issue by that date will be automatically closed.

Thank you for your understanding and for being a part of our community!

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enables better visibility into hook execution by allowing hooks to send system messages directly to the CLI UI. By introducing a configurable setting, users can now opt-in to see feedback from their hooks, which is rendered as part of the chat history. This improves the extensibility of the hook system and provides clearer user feedback during automated processes.

Highlights

  • New Configuration Setting: Added hooksConfig.showOutput to allow users to toggle the display of hook-generated system messages in the CLI UI.
  • Hook Output Processing: Updated HookRunner to track output format (JSON vs. text) and HookEventHandler to emit structured events when system messages are present.
  • UI Integration: Enhanced the CLI chat interface to listen for hook-system-message events and display them as info messages, including the source hook name.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

You already have 7 pull requests open. Please work on getting existing PRs merged before opening more.

@github-actions github-actions bot closed this Apr 3, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a new configuration setting, hooksConfig.showOutput, which allows users to display informational messages returned by hooks directly in the CLI UI. The changes include updating the configuration schemas, documentation, and core event handling to capture and emit hook system messages when they are returned in JSON format. The UI components were also updated to render these messages with an optional source indicator. I have no feedback to provide as there were no review comments to assess.

Note: Security Review did not run due to the size of the PR.

@abhipatel12 abhipatel12 reopened this Apr 3, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 3, 2026

Size Change: +1.29 kB (0%)

Total Size: 34 MB

Filename Size Change
./bundle/chunk-GFUOVHXW.js 0 B -1.96 MB (removed) 🏆
./bundle/chunk-HZQ7RGVS.js 0 B -3.15 MB (removed) 🏆
./bundle/chunk-NZHVEBX6.js 0 B -14.8 MB (removed) 🏆
./bundle/core-LTM54EZW.js 0 B -45.2 kB (removed) 🏆
./bundle/devtoolsService-UVLZLVQA.js 0 B -28.4 kB (removed) 🏆
./bundle/interactiveCli-HRMFEVMJ.js 0 B -1.64 MB (removed) 🏆
./bundle/oauth2-provider-227FFFWY.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-3EDC2OSP.js 14.8 MB +14.8 MB (new file) 🆕
./bundle/chunk-7QX53IVP.js 3.15 MB +3.15 MB (new file) 🆕
./bundle/chunk-UV75IQ6X.js 1.96 MB +1.96 MB (new file) 🆕
./bundle/core-DVV6OL7V.js 45.2 kB +45.2 kB (new file) 🆕
./bundle/devtoolsService-JHTQBWLN.js 28.4 kB +28.4 kB (new file) 🆕
./bundle/interactiveCli-IPU7ZBU4.js 1.64 MB +1.64 MB (new file) 🆕
./bundle/oauth2-provider-ERW4MBDR.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/gemini.js 552 kB 0 B
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-ACCRGPX3.js 0 B -980 B (removed) 🏆
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/memoryDiscovery-JL5XPI6O.js 980 B +980 B (new file) 🆕

compressed-size-action

@gemini-cli gemini-cli bot added the status/need-issue Pull requests that need to have an associated issue. label Apr 3, 2026
Copy link
Copy Markdown
Contributor

@abhipatel12 abhipatel12 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Couple settings nits but LGTM!

Comment thread packages/cli/src/config/settingsSchema.ts Outdated
Comment thread packages/cli/src/config/settingsSchema.ts Outdated
@mbleigh mbleigh enabled auto-merge April 7, 2026 17:11
@mbleigh mbleigh added this pull request to the merge queue Apr 7, 2026
Merged via the queue into main with commit e432f7c Apr 7, 2026
26 of 27 checks passed
@mbleigh mbleigh deleted the mb/hook-display branch April 7, 2026 18:41
warrenzhu25 pushed a commit to warrenzhu25/gemini-cli that referenced this pull request Apr 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status/need-issue Pull requests that need to have an associated issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants