The argument in one line.
Gemini CLI is a serious free alternative to Claude Code with a 5x larger context window and open-source architecture, but Claude Code still outperforms it on real coding tasks because Gemini 2.5 Flash struggles with basic design work.
Read if. Skip if.
- A developer working with large codebases who needs 5x more context window than Claude and wants to evaluate open-source alternatives before committing to paid tools.
- Someone building on a production codebase who can use the free tier (1,000 queries/day) and wants to compare Gemini CLI's performance directly against Claude Code on real tasks.
- A developer at a company with data privacy concerns who needs an AI coding agent but can't risk Google training on their codebase with the free tier.
- You're completely new to terminal commands and coding — the video assumes you can navigate a command line and understand basic dev setup steps.
- You've already settled on Claude Code and have no budget or motivation to test alternatives — this is a comparative evaluation, not a definitive winner declaration.
- You work with proprietary enterprise code and need a tool that guarantees zero data usage without paying for an API key — the video doesn't resolve this tradeoff clearly.
The full version, fast.
Google's new Gemini CLI is a free, open-source autonomous coding agent with a one-million-token context window and 1,000 daily queries, but in a live head-to-head it loses to Claude Code on a basic front-end task. Installation runs through one npm command, and the smartest configuration move is creating a .gemini/settings.json that points contextFileName to your existing agents.md, so you reuse the same optimized 400-line system prompt across Codex, Claude Code, and Gemini instead of maintaining parallel files. Logging in with Google is free but trains on your data and silently downgrades you to 2.5 Flash under load; an API key keeps you on 2.5 Pro and private. Today, pick Claude Code for capability and keep Gemini CLI installed for the free tier, the huge context window, and the forkable open-source codebase that will close the gap fast.
Chat with this breakdown — free.
Sign in and you get 23 free chat messages on us — ask for the hook, quote a framework, find the exact transcript moment, generate a markdown action plan. Bring your own key when you want unlimited.
Create a free account →Where the time goes.

01 · Cold open — three advantages in 12 seconds
Gemini CLI README with animated >GEMINI logo. Open source + 1M context + 1K free queries/day stated immediately.

02 · Install + auth options
npm install -g @google/gemini-cli. Node.js 18+ prerequisite. Three auth paths: Google login (free, data training), API key (paid, no training, always Pro), Vertex AI.

03 · Free tier graphic + context comparison
Full-screen card: 60 req/min, 1K req/day, Open Source, Free. Model comparison chart showing Gemini 2.5 Pro context is 5× larger than Claude Opus/Sonnet.

04 · Running Gemini in Cursor
Opens Gemini CLI inside Cursor terminal. Theme selection, /auth flow. Running on real Vectal production codebase (React/TypeScript/Supabase).

05 · GEMINI.md vs settings.json + API rate limit
Default GEMINI.md is vague 20 lines. Hits 429 rate limit errors with API key mid-demo. Switches back to Google login. Navigates docs to find settings.json configuration trick.

06 · AGENTS.md redirect trick
Create .gemini/settings.json with contextFileName: AGENTS.md. Lets you reuse a single highly-optimized prompt file across Gemini, Codex, and Claude Code. Shows his 400-line AGENTS.md now powering Gemini CLI.

07 · Live coding task — Gemini fails
Prompt: replace emoji thumbs buttons with Lucide React icons in ThumbsFeedback.tsx. Gemini reads file twice, gets downgraded to 2.5 Flash, request cancelled, no changes applied.

08 · Vectal sponsor segment
Demo of vectal.ai AI task manager — project-level system prompts, team context, Gemini 2.5 Pro inside the app.

09 · Claude Code one-shots the same prompt
Same prompt, Claude Code. Reads file, applies Lucide React icons with correct green/red coloring, done in one shot. Direct side-by-side contrast.

10 · Verdict — today: Claude Code. Tomorrow: watch Gemini
Claude Code clearly better now. Gemini CLI's open-source fork-ability, free tier, 1M context are structural advantages worth tracking. Less than 24 hours old.

11 · Gemini CLI tools demo + web search
Lists all available tools: ReadFolder, WriteFile, Shell, Memory, GoogleSearch, WebFetch. Runs web search — Gemini searches for news about itself using GoogleSearch tool.

12 · Extended Vectal team pitch + part-two CTA
Team plan demo with per-person AI context. CTA: comment 'part two' for advanced video on MCPs, memory, web tools.
Lines worth screenshotting.
- Gemini CLI gives you 1,000 queries per day free with a Google login, which is more than most developers will use, making it effectively a free Claude Code competitor.
- Google trains on your data with the free login tier — developers working on commercial codebases they don't own should use an API key even at the cost of a paid subscription.
- During peak usage periods, the free Gemini login tier gets downgraded from Gemini 2.5 Pro to Gemini 2.5 Flash without warning — a reliability risk for time-sensitive work.
- Gemini 2.5 Pro has a five times larger context window than Claude's Opus or Sonnet models, making it the better tool for very large codebases where full context is required.
- Setting the codecFilename setting to agents.md in the Gemini settings.json makes Gemini CLI use your existing Claude Code AGENTS.md — eliminating the need to maintain two instruction files.
- Running Gemini CLI and Claude Code side by side in split terminal panes lets you assign tasks to both agents simultaneously and compare outputs on the same codebase.
- On a real production coding task, Claude Code one-shotted the implementation while Gemini 2.5 Flash stumbled — Gemini Pro's structural advantages do not always translate to task success.
- The Gemini CLI update command is the same as the install command — running it every morning both updates the tool and serves as the day's first launch.
- Open-source AI coding agents are structurally different from commercial ones: they can be forked, modified, and self-hosted, which matters for teams with data sovereignty requirements.
- Gemini models are among the most cost-effective in the world — paying for the API key buys data privacy, model consistency, and access to Pro even during peak demand.
- The most credible benchmark for a coding agent is a live head-to-head on your actual codebase, not a synthetic leaderboard score — only one agent completed the task correctly.
- Tool proliferation — Claude Code, Codex, Gemini CLI, Cursor — is pushing developers toward multi-agent workflows where different tools handle different task types simultaneously.
The AGENTS.md redirect is immediately stealable.
One settings.json file lets you point Gemini CLI at the same AGENTS.md you already use for Claude Code — no rewriting prompts, instant upgrade.
- Create .gemini/settings.json with {"contextFileName": "AGENTS.md"} in your project root.
- Your existing Claude Code or Codex AGENTS.md now powers Gemini CLI too.
- For JoeFlow or any project where you're comparing agents, run both in Cursor split-screen — same codebase, same prompt, judge the diff.
- The open-source angle is a product story: Gemini CLI can be forked and shipped as a custom coding agent. Worth watching for MCN+ tooling.
- Use the auth framing (free/paid/enterprise tier) as a template for any tool comparison video — it positions the tradeoffs cleanly without FUD.
Terms worth knowing.
- Gemini CLI
- Google's open-source command-line AI coding agent, powered by the Gemini 2.5 Pro model, offering a free tier of 1,000 queries per day and a context window significantly larger than competing tools.
- Claude Code
- Anthropic's command-line AI coding agent that operates autonomously in a terminal, reading and editing codebases based on natural-language instructions.
- context window
- The maximum amount of text — code, instructions, and conversation history — an AI model can hold in memory at once during a single session, measured in tokens.
- autonomous coding agent
- An AI tool that can independently read a codebase, plan changes, write and run code, and iterate without requiring step-by-step human input for each action.
- npm (Node Package Manager)
- The standard package manager for JavaScript and Node.js used to install command-line tools and libraries from the public registry with a single terminal command.
- Node.js
- A JavaScript runtime that lets developers run JavaScript code outside a browser, required here as a prerequisite for installing Gemini CLI.
- AGENTS.md
- A configuration file that some AI coding agents read for project-level instructions, analogous to CLAUDE.md — used here as a redirect trick to reuse existing Claude instructions with Gemini CLI.
- open source
- Software whose source code is publicly available and free to inspect, modify, and redistribute — relevant here because Gemini CLI's internals can be audited and customized, unlike proprietary tools.
- Gemini 2.5 Flash
- A faster, lower-cost variant of Google's Gemini 2.5 model family, optimized for speed rather than maximum capability — used in the comparison test in this video.
- Gemini 2.5 Pro
- Google's most capable Gemini model at the time, used as the foundation for Gemini CLI, noted for its large context window advantage over Claude models.
- Codex
- OpenAI's cloud-based AI coding agent, launched around the same period, competing in the same autonomous software engineering category as Claude Code and Gemini CLI.
Things they pointed at.
Lines you could clip.
“1,000 queries per day. Most people will not even get close to 1,000 prompts a day, which means Gemini CLI, for most of you, will be completely free.”
“Google open-sourcing Gemini CLI — whereas Claude Code and Codex are not fully open-sourced — is a huge power move.”
“Cloud Code was able to one-shot it. No problem.”
“It's been less than twenty-four hours since they released it. So for now, Claude Code is clearly better, but I would keep testing Gemini CLI.”
Word for word.
Don't just watch it. Burn it in.
See every word as it's spoken — crank it to 2× and still catch all of it. The same dual-channel trick behind Amazon's Kindle + Audible.
The bait, then the rug-pull.
Three differentiators in one breath — open source, one-million-token context, and a thousand free queries a day — before the title card appears. David Ondrej's cold open on the Gemini CLI GitHub README sets the frame fast: this is a structural threat to Claude Code, even if the polish isn't there yet.
Named ideas worth stealing.
Auth Tier Matrix
- Google login (free, data training on)
- API key (paid, data training off, always Pro)
- Vertex AI (enterprise)
Which Gemini CLI auth to use depends on data privacy needs and budget — free users risk getting downgraded to 2.5 Flash at peak times.
AGENTS.md Redirect Trick
Create .gemini/settings.json with contextFileName pointing to your existing AGENTS.md. One optimized prompt file works across Gemini CLI, Codex, and Claude Code.
Context Window as Codebase-Fit Signal
Gemini 2.5 Pro's 1M context vs Claude's 200K means Gemini is structurally better for large monorepos, even if current quality lags.
How they asked for the click.
“If you want me to make another video on it, comment below 'part two' and I'll make it happen.”
Soft engagement CTA seeded earlier at 11:18 and closed out at end. Works because the first video intentionally leaves MCPs, memory, and web tools uncovered.




































































