git404hub

google-gemini/gemini-cli

★ 103,272TypeScriptAudience · developerComplexity · 2/5ActiveLicenseSetup · moderate

tl;dr

A command-line tool that brings Google's Gemini AI model into your terminal, letting you ask questions, edit code, run commands, and search the web without leaving the shell.

vibe map

mindmap
  root((Gemini CLI))
    What it does
      Interactive AI agent
      Code editing
      Shell commands
      Web search
    How to use
      npm or Homebrew
      Google OAuth login
      Type prompts
      Non-interactive mode
    Key features
      1M token context
      Free tier available
      Model Context Protocol
      GitHub Actions
    Use cases
      Code debugging
      Automated tasks
      PR reviews
      Terminal workflows
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what people make with this

VIBE 1

Debug code issues by asking Gemini questions directly from your terminal without switching windows.

VIBE 2

Automate repetitive tasks like file editing, running shell commands, and fetching web data in a single prompt.

VIBE 3

Review pull requests and triage GitHub issues automatically using the Gemini CLI GitHub Action.

VIBE 4

Build custom integrations by connecting your own tools via the Model Context Protocol.

stack

TypeScriptNode.jsGoogle Gemini APIOAuth 2.0

setup vibes

Difficulty · moderate time til it works · 30min

Requires Google Gemini API key and OAuth 2.0 authentication setup.

Use freely for any purpose, including commercial use, as long as you include the original copyright notice and license text.

in plain english

Gemini CLI is an open-source AI agent from Google that brings the Gemini model into your terminal, the text-based window where developers type commands. Instead of switching to a browser to chat with an AI, you run a single command and start a conversation that already has access to your files, your shell, and tools for searching the web. The README describes it as the most direct path from your prompt to Google's Gemini model. It installs through npm, Homebrew, MacPorts, or Anaconda, or you can launch it instantly with npx. Inside, it acts as an agent: it can read and edit files in a codebase, run shell commands, fetch pages from the web, and use Google Search to ground its answers in real-time information. It supports the Model Context Protocol (MCP), an open standard for plugging extra tools and data sources into an AI assistant. Conversation checkpoints save and resume long sessions, and project-specific GEMINI.md files tailor behavior per repository. A non-interactive mode takes a prompt and returns plain text or structured JSON for shell scripts, plus a companion GitHub Action runs pull-request reviews and issue triage in CI. You would use Gemini CLI if you spend most of your day in the terminal and want an AI pair-programmer that can actually touch your code, if you want to script Gemini into a build pipeline, or if you want to wire it into GitHub workflows. It offers three authentication paths, Google sign-in with a free tier, a Gemini API key, or Vertex AI for enterprise use. The project is written in TypeScript and licensed under Apache 2.0.

prompts (copy fr)

prompt 1
Install Gemini CLI and set it up with my Google account, then use it to explain what this error message means and suggest a fix.
prompt 2
Use Gemini CLI to search the web for documentation on [topic], then write a summary to a file in my current directory.
prompt 3
Set up the Gemini CLI GitHub Action to automatically review my pull requests and leave comments with suggestions.
prompt 4
Create a shell script that uses Gemini CLI in non-interactive mode to analyze a log file and output JSON results.
prompt 5
Use Gemini CLI with the Model Context Protocol to connect a custom tool that [specific task], then test it with a prompt.
peek the repo → explain another one

← google-gemini on gitmyhub — every repo by this author, as a profile.

double-check against the repo, no cap.