Docs: Add documentation for notifications (experimental)(macOS)

[jkcinouye]

Summary

Adds documentation for Notification settings.

Details

Adds a small page for Notifications.

Related Issues

Closes #21162.

How to Validate

This is just a small page to add notifications to our docs. Review for any inaccuracies, spelling errors, or other mistakes.

Pre-Merge Checklist

• Updated relevant documentation and README (if needed)
• Added/updated tests (if needed)
• Noted breaking changes (if any)
• Validated on required platforms/methods:
  • MacOS
    • npm run
    • npx
    • Docker
    • Podman
    • Seatbelt
  • Windows
    • npm run
    • npx
    • Docker
  • Linux
    • npm run
    • npx
    • Docker

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! 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 introduces comprehensive documentation for the experimental notification feature in Gemini CLI. The new content details the feature's purpose, system requirements, configuration methods, and various notification types, enhancing user understanding and discoverability of this functionality. The documentation is integrated into the existing sidebar navigation.

Highlights

• New Documentation Page: A dedicated documentation page for the Gemini CLI's experimental notification feature has been added, detailing its functionality, requirements, and usage.
• Notification Feature Details: The new documentation explains that notifications are currently macOS-only, utilize OSC 9 terminal escape sequences, and can be enabled via the /settings command or by modifying settings.json. It also outlines two types of notifications: 'Action required' and 'Session complete'.
• Sidebar Navigation Update: The docs/sidebar.json file has been updated to include a link to the new 'Notifications' page within the CLI section, marked with an experimental badge.

Changelog

• docs/cli/notifications.md
  • Added a new documentation page explaining Gemini CLI system notifications.
  • Detailed the requirements (macOS, OSC 9 terminal support), enablement steps (via /settings or settings.json), and types of notifications (action required, session complete).
• docs/sidebar.json
  • Inserted a new entry for 'Notifications' into the CLI section of the sidebar.
  • Included a '🔬' badge to indicate the experimental nature of the feature and linked to the new docs/cli/notifications.md page.

Activity

• The pull request was created by jkcinouye to add documentation for the experimental notifications feature.
• No further review comments or activity have been recorded yet.

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.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

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. ↩

[gemini-code-assist]

Code Review

This pull request introduces documentation for the new experimental notifications feature on macOS. A new page, notifications.md, has been added, detailing the feature's purpose, requirements, and configuration. The documentation sidebar has also been updated to include a link to this new page. The changes are accurate and well-structured, correctly reflecting the feature's implementation as seen in the related source code. No high or critical issues were found in this documentation update.

_{Note: Security Review has been skipped due to the limited scope of the PR.}

[github-actions]

Size Change: -4 B (0%)

Total Size: 26 MB

ℹ️ View Unchanged

Filename	Size	Change
./bundle/gemini.js	25.5 MB	-4 B (0%)
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js	221 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js	227 kB	0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js	11.5 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

_{compressed-size-action}