feat: add /introspect slash command

[NTaylorMullen]

Summary

Adds a new custom slash command /introspect {args} to the project's .gemini/commands/ directory. This command allows users to ask the model to analyze its own system instructions and internal reasoning for a specific action or decision.

Example:

Details

The /introspect command is implemented as a TOML file in .gemini/commands/introspect.toml. It uses the {{args}} placeholder to inject the user's specific point of interest into a detailed prompt that asks the model for:

1. Influential system instructions.
2. Internal thought process.
3. Potential ambiguities or conflicting instructions.

This is intended to help developers understand how system instructions (global, workspace, or GEMINI.md) are interpreted by the model.

Related Issues

None.

How to Validate

1. Start Gemini CLI from the project root.
2. Invoke the command: /introspect why did you use a specific tool in the previous turn?
3. Verify that the model responds with an analysis of its instructions and reasoning.

Pre-Merge Checklist

• Updated relevant documentation and README (if needed)
• Added/updated tests (if needed) - Verified existing FileCommandLoader tests pass.
• Noted breaking changes (if any)
• Validated on required platforms/methods:
  • MacOS
    • npm run

[gemini-code-assist]

Note

Gemini is unable to generate a summary for this pull request due to the file types involved not being currently supported.

[gemini-cli]

Hi @NTaylorMullen, 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!

[github-actions]

Size Change: -2 B (0%)

Total Size: 23.2 MB

ℹ️ View Unchanged

Filename	Size	Change
./bundle/gemini.js	23.2 MB	-2 B (0%)
./bundle/sandbox-macos-permissive-closed.sb	1.03 kB	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-closed.sb	3.29 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

_{compressed-size-action}