feat(cli): add streamlined gemini gemma local model setup

[Samee24]

Summary

This PR introduces the gemini gemma command for streamlined local model setup
and the gemini gemma logs command to view LiteRT server logs.

Details

• Added gemini gemma command to manage local models.
• Added gemini gemma logs command to inspect server logs.

Related Issues

How to Validate

1. Run npm run build
2. Test the new command using npx gemini gemma
3. Test the logging functionality with npx gemini gemma logs

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-cli]

Hi @Samee24, 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: +48.8 kB (+0.15%)

Total Size: 33.7 MB

Filename	Size	Change
./bundle/chunk-JV5QFHAV.js	0 B	-14.5 MB (removed)	🏆
./bundle/chunk-M2BZOK3M.js	0 B	-3.43 MB (removed)	🏆
./bundle/chunk-Y2HM5TZW.js	0 B	-3.8 kB (removed)	🏆
./bundle/core-52JOSFDT.js	0 B	-46.7 kB (removed)	🏆
./bundle/devtoolsService-AC5EUDHN.js	0 B	-28.4 kB (removed)	🏆
./bundle/gemini-RXBYXRNV.js	0 B	-553 kB (removed)	🏆
./bundle/interactiveCli-BIOLCHJ6.js	0 B	-1.29 MB (removed)	🏆
./bundle/oauth2-provider-4RRC2JWK.js	0 B	-9.16 kB (removed)	🏆
./bundle/chunk-77NJCI3N.js	674 kB	+674 kB (new file)	🆕
./bundle/chunk-7YX4TTLZ.js	14.5 MB	+14.5 MB (new file)	🆕
./bundle/chunk-APUNYE3V.js	2.72 MB	+2.72 MB (new file)	🆕
./bundle/chunk-D4YI25NZ.js	3.8 kB	+3.8 kB (new file)	🆕
./bundle/chunk-PFRVZSJX.js	3.43 kB	+3.43 kB (new file)	🆕
./bundle/chunk-R2J2TZ24.js	49.2 kB	+49.2 kB (new file)	🆕
./bundle/core-VSQHJAXC.js	46.7 kB	+46.7 kB (new file)	🆕
./bundle/devtoolsService-2FLBLH4M.js	28.4 kB	+28.4 kB (new file)	🆕
./bundle/gemini-LJSRG2GX.js	576 kB	+576 kB (new file)	🆕
./bundle/interactiveCli-UDT6634M.js	1.3 MB	+1.3 MB (new file)	🆕
./bundle/liteRtServerManager-CIVSIWRH.js	2.08 kB	+2.08 kB (new file)	🆕
./bundle/oauth2-provider-3XX2EVV5.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/chunk-YIPDXML5.js	1.97 MB	0 B
./bundle/cleanup-PYTINKQK.js	0 B	-932 B (removed)	🏆
./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/examples/hooks/scripts/on-start.js	188 B	0 B
./bundle/examples/mcp-server/example.js	1.43 kB	0 B
./bundle/gemini.js	4.97 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-NXEEFR74.js	980 B	0 B
./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/cleanup-ZFAANEF3.js	932 B	+932 B (new file)	🆕
./bundle/start-EB6TWS4H.js	622 B	+622 B (new file)	🆕

_{compressed-size-action}

[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 implements a comprehensive local model routing system for the Gemini CLI. By leveraging the LiteRT-LM runtime, users can now run a local Gemma model to classify requests, optimizing performance and costs by routing simple tasks to Flash and complex tasks to Pro. The changes include robust CLI tooling for installation, lifecycle management, and diagnostics, alongside UI enhancements to provide visibility into the routing status.

Highlights

• New CLI Commands: Introduced the gemini gemma command suite, including setup, start, stop, status, and logs to manage local model routing.
• Automated Server Management: Added background server management with auto-start capabilities and persistent logging for the LiteRT-LM runtime.
• Configuration Updates: Updated settings schema to include autoStartServer and binaryPath for customizable local model routing.
• UI Integration: Added a new /gemma slash command and a corresponding UI component to display the status of the local model router.

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

[Abhijit-2592]

This looks excellent. The security concerns around the hybrid settings scope and binary integrity have been thoroughly addressed. The implementation of the log reader and process management is also much more robust.

I've added a couple of minor nits regarding consistency in port parsing and settings defaults, but these are not blockers. Great work!

[Abhijit-2592]

Nits for consideration:

1. packages/cli/src/services/liteRtServerManager.ts (line 29): Consider using the parsePortFromHost helper from platform.ts here for consistency and better error handling instead of the regex.
2. packages/cli/src/config/settingsSchema.ts (line 2169): The schema default for autoStartServer is false, but the setup command initializes it to true. This is perfectly fine for the setup flow, but we might want to ensure the documentation reflects this behavior.