Gemini CLI: Free Terminal AI Agent That Replaces Claude Code

Step 1: Install Gemini CLI

Run the following in your terminal:

bash
npm install -g @google/gemini-cli

This installs the agent globally. You need Node.js 18 or higher. Confirm it worked:

bash
gemini --version

Step 2: Authenticate with Your Google Account

Run:

bash
gemini auth login

This opens a browser prompt. Sign in with any personal Google account. No API key, no billing setup, no credit card. The free tier (1,000 requests/day, 1M token context window) activates automatically.

Step 3: Point Gemini CLI at Your Repo

Navigate to your project folder and launch the interactive agent:

bash
cd your-project
gemini

Gemini CLI reads your working directory as context. From here you can ask it to explain the codebase, fix bugs, write tests, or scaffold new features.

Step 4: Run Your First Useful Prompt

A strong opening prompt for any unfamiliar repo:

> Summarize what this project does, list the main entry points, and flag anything that looks like a bug or a security concern.

The 1M token context window means it can ingest large codebases in a single pass without chunking workarounds.

Step 5: Use It as an Agentic Coding Loop

Gemini CLI can read files, write files, run shell commands, and chain actions based on your instructions. A practical loop:

1. Describe the feature or fix you want.
2. Let it propose a plan.
3. Approve, then let it execute.
4. Review the diff with git diff.

This is the same agentic pattern Claude Code uses, driven by the same underlying idea of an LLM with tool access running in your terminal.

---

Why This Works

Gemini CLI offloads the expensive part (inference on a frontier model) to Google's infrastructure, which they are willing to subsidize at scale to drive developer adoption. The Apache 2.0 license means you can embed it in internal tooling without legal friction. For solo workflows, 1,000 requests/day is enough to cover a full coding session without hitting limits.

---

Pro Tips

• Start with a repo map prompt. Ask Gemini to describe the folder structure and key modules before giving it tasks. This primes it for accurate edits.
• Use the 1M context for large diffs. Paste long pull request diffs or log files directly into the prompt. Most other free tools will truncate this.
• Check the GitHub repo for updates. Gemini CLI is new and shipping fast. Star google-gemini/gemini-cli on GitHub to track breaking changes.
• Keep a .geminiignore file. If your repo has secrets or large build artifacts, exclude them the same way you would with .gitignore to keep prompts clean and avoid leaking sensitive data.

---

Gemini CLI is available now at github.com/google-gemini/gemini-cli. Free, open-source, and ready to drop into your existing shell workflow today.