gemini-cli icon indicating copy to clipboard operation
gemini-cli copied to clipboard

Introspection agent demo

Open scidomino opened this issue 1 month ago • 2 comments

Summary

Introduces an introspection agent which can answer questions about Gemini CLI.

Related Issues

How to Validate

(in an empty working dir)

npx https://github.com/google-gemini/gemini-cli#tomm_introspection_agent -- "is ctrl+j a hotkey you support and if so, what does it do?"

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

scidomino avatar Dec 18 '25 00:12 scidomino

Summary of Changes

Hello @scidomino, I'm Gemini Code Assist[^1]! 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 significantly enhances the Gemini CLI's capabilities by introducing an "Introspection Agent." This agent is designed to be self-aware, capable of answering questions about the CLI's features, configuration, and current state. It achieves this through a newly implemented GetInternalDocsTool that provides access to the project's internal documentation, and by injecting relevant runtime context directly into the agent's prompts. This change aims to improve the CLI's ability to provide informative responses to user queries about itself.

Highlights

  • Introspection Agent: A new agent, IntrospectionAgent, has been added. Its purpose is to answer questions about the Gemini CLI by leveraging its own documentation and runtime information.
  • Internal Documentation Tool: A new tool, GetInternalDocsTool, is introduced. This tool enables agents to programmatically access and read internal documentation files, either by listing available files or retrieving the content of a specific one.
  • Runtime Context Injection: The agent execution framework now automatically injects crucial runtime context, such as the CLI version, active model, and current date, into agent prompts, making agents more aware of their operational environment.
  • Documentation Bundling: Build and bundling scripts have been updated to ensure that the docs directory is included in the distributed and bundled packages, making the internal documentation accessible to the new GetInternalDocsTool.
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 :thumbsup: and :thumbsdown: 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.

[^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[bot] avatar Dec 18 '25 00:12 gemini-code-assist[bot]

Size Change: +8.65 kB (+0.04%)

Total Size: 22 MB

Filename Size Change
./bundle/gemini.js 22 MB +8.65 kB (+0.04%)
ℹ️ View Unchanged
Filename Size
./bundle/sandbox-macos-permissive-closed.sb 1.03 kB
./bundle/sandbox-macos-permissive-open.sb 890 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB
./bundle/sandbox-macos-restrictive-closed.sb 3.29 kB
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB

compressed-size-action

github-actions[bot] avatar Dec 18 '25 00:12 github-actions[bot]

/gemini review

scidomino avatar Dec 19 '25 21:12 scidomino