Gemini CLI

原始链接: https://github.com/google-gemini/gemini-cli

The Gemini CLI is a command-line tool that utilizes the Gemini AI APIs to accelerate workflows by understanding code and connecting to various tools. Users can query and edit large codebases, generate applications from various inputs, automate tasks like pull request management, and integrate with external tools for media generation or search. To get started, ensure Node.js 18+ is installed, then install with `npm install -g @google/gemini-cli` or run directly with `npx https://github.com/google-gemini/gemini-cli`. Authenticate with a Google account for a request limit, or use an API key from Google AI Studio for specific models or higher limits by setting the `GEMINI_API_KEY` environment variable. The CLI allows for project creation, code analysis, implementing issues, migrating codebases, and integrating with tools. It also facilitates tasks like image conversion, invoice organization, and slide deck creation. Remember that using the Gemini API is subject to its terms of service.

原文

This repository contains the Gemini CLI, a command-line AI workflow tool that connects to your tools, understands your code and accelerates your workflows.

With the Gemini CLI you can:

Query and edit large codebases in and beyond Gemini's 1M token context window.
Generate new apps from PDFs or sketches, using Gemini's multimodal capabilities.
Automate operational tasks, like querying pull requests or handling complex rebases.
Use tools and MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria
Ground your queries with the Google Search tool, built in to Gemini.

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

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

npx https://github.com/google-gemini/gemini-cli

Or install it with:

npm install -g @google/gemini-cli

Pick a color theme
Authenticate: When prompted, sign in with your personal 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:

Generate a key from Google AI Studio.
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, including Google Workspace accounts, see the authentication guide.

Once the CLI is running, you can start interacting with Gemini from your shell.

You can start a project from a new directory:

$ cd new-project/
$ gemini
> Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide

Or work with an existing project:

$ git clone https://github.com/google-gemini/gemini-cli
$ cd gemini-cli
$ gemini
> Give me a summary of all of the changes that went in yesterday

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.

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.

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: