Go to file
Bryan Morgan e356949d3f
[JUNE 25] Permanent failover to Flash model for OAuth users after persistent 429 errors (#1376)
Co-authored-by: Scott Densmore <scottdensmore@mac.com>
2025-06-24 22:48:55 +00:00
.gcp refactor: rename gemini-code to gemini-cli (#822) 2025-06-07 14:27:22 -07:00
.gemini toggle off (#809) 2025-06-07 00:06:15 -07:00
.github feat: add merge_group trigger to CI and E2E workflows (#1400) 2025-06-24 15:30:31 -07:00
.vscode Scotdensmore/first run auth fix (#1322) 2025-06-22 22:52:25 -07:00
docs Documents: Add docs tools pages (#1397) 2025-06-24 22:31:58 +00:00
eslint-rules feat: add custom eslint rule for cross-package imports (#77) 2025-04-21 08:02:11 -07:00
integration-tests test: add integration test for simple mcp server (#1199) 2025-06-18 15:53:58 -07:00
packages [JUNE 25] Permanent failover to Flash model for OAuth users after persistent 429 errors (#1376) 2025-06-24 22:48:55 +00:00
scripts Jacob314/max old space (#1314) 2025-06-24 14:18:55 -07:00
.gitattributes Adding .gitattributes (#1303) 2025-06-23 06:58:41 +00:00
.gitignore Preflight and integration npx (#1096) 2025-06-16 15:27:29 +00:00
.npmrc refactor: rename gemini-code to gemini-cli (#822) 2025-06-07 14:27:22 -07:00
.prettierrc.json Run `npm run format` 2025-04-17 15:29:34 -07:00
CONTRIBUTING.md Updating CONTRIBUTING.md (#1144) 2025-06-17 13:16:28 -07:00
Dockerfile fix version release for Dockerfile build (#1080) 2025-06-16 06:13:39 +00:00
GEMINI.md Preflight and integration npx (#1096) 2025-06-16 15:27:29 +00:00
LICENSE add LICENSE (#25) 2025-04-18 10:30:07 -07:00
Makefile Remove #early-access from npx references (#1262) 2025-06-20 20:32:27 +00:00
README.md Added ToS links for each surface (#1365) 2025-06-24 22:31:50 +00:00
esbuild.config.js fix version release for Dockerfile build (#1080) 2025-06-16 06:13:39 +00:00
eslint.config.js Preflight and integration npx (#1096) 2025-06-16 15:27:29 +00:00
package-lock.json Use concurrently to run start script with GCP telemetry (#1329) 2025-06-23 22:01:22 +00:00
package.json Use concurrently to run start script with GCP telemetry (#1329) 2025-06-23 22:01:22 +00:00
tsconfig.json Fix: Prevent hang in large directories by using BFS for getFolderStru… (#470) 2025-05-22 10:47:21 -07:00

README.md

Gemini CLI

Gemini CLI CI

This repository contains the Gemini CLI tool.

Gemini CLI Screenshot

Quickstart

  1. Prerequisites: Ensure you have Node.js version 18 or higher installed.

  2. Run the CLI: Execute the following command in your terminal:

    npx https://github.com/google-gemini/gemini-cli
    
  3. Authenticate: When prompted, sign in with your Google account. This will grant you up to 60 model requests per minute and 1,000 model requests per day using Gemini 2.5 Pro.

You are now ready to use the Gemini CLI!

For advanced use or increased limits:

If you need to use a specific model or require a higher request capacity, you can use an API key:

  1. Generate a key from Google AI Studio.

  2. Set it as an environment variable in your terminal. Replace YOUR_API_KEY with your generated key.

    export GEMINI_API_KEY="YOUR_API_KEY"
    

For other authentication methods, see the authentication guide.

Examples

Once the CLI is running, you can start interacting with Gemini from your shell. Try a simple query:

> How can I build a web app?

Or ask it to perform a task using its tools:

> List files in the current directory.

Next steps

Explore a new codebase

Start by cding into an existing or newly-cloned repository and running gemini.

> Describe the main pieces of this system's architecture.
> What security mechanisms are in place?

Work with your existing code

> Implement a first draft for GitHub issue #123.
> Help me migrate this codebase to the latest version of Java. Start with a plan.

Automate your workflows

Use MCP servers to integrate your local system tools with your enterprise collaboration suite.

> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.
> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.

Interact with your system

> Convert all the images in this directory to png, and rename them to use dates from the exif data.
> Organise my PDF invoices by month of expenditure.

Gemini APIs

This project leverages the Gemini APIs to provide AI capabilities. For details on the terms of service governing the Gemini API, please refer to the terms for the access mechanism you are using: