Gemini CLI Local Setup¶
Standard Operating Procedure · Version 1.0 · Last Updated: May 12, 2026
Scope: Local Development Environment Setup
Executive Summary¶
| Requirement | Specification |
|---|---|
| Runtime | Node.js (v18.0.0 or higher) |
| Package Mgr | npm (comes with Node.js) |
| Installation | Global install via npm install -g @google/gemini-cli |
| Auth Method | Browser-based Google Authentication (No API Key required) |
1. Overview¶
This SOP establishes the procedure for installing and authenticating the Gemini CLI on a local machine. Following these steps ensures a consistent development environment for all Cavtera team members.
2. Setup Instructions¶
2.1 Prerequisites¶
Requirement: Ensure the following software is installed before proceeding.
| Component | Minimum Version | Purpose |
|---|---|---|
| Node.js | 18.0.0 |
JavaScript runtime required for the CLI |
| npm | Included | Package manager used for installation |
2.2 Installation¶
Requirement: The Gemini CLI must be installed globally to be accessible from any directory.
| Action | Command |
|---|---|
| Install CLI | npm install -g @google/gemini-cli |
2.3 Authentication¶
Requirement: Authentication must be performed via the built-in browser flow.
| Step | Action | Description |
|---|---|---|
| 1 | Start CLI | Run gemini in your terminal. |
| 2 | Browser Redirect | The CLI will automatically open your default browser to the Google sign-in page. |
| 3 | Sign In | Log in with your authorized Google account. |
| 4 | Confirmation | Once completed in the browser, return to your terminal; the session will be authenticated. |
3. Usage¶
Once authenticated, you can interact with the CLI or view help documentation.
| Command | Purpose |
|---|---|
gemini |
Starts an interactive session |
gemini --help |
Displays available commands and options |
4. Quick Reference Checklist¶
Use this checklist to verify your setup:
- [ ] Node.js — Version 18.0.0 or higher installed.
- [ ] Installation — CLI installed globally via npm.
- [ ] Authentication — Successfully logged in via the browser redirect.
- [ ] Verification — Able to run
geminiand see the prompt.
5. Revision History¶
| Version | Author | Description |
|---|---|---|
| 1.0 | Gemini CLI | Initial release |