{"schema_version":"1.2","slug":"gemini-cli","url":"https://www.launchpadhq.io/platform/gemini-cli/guide","data_url":"https://www.launchpadhq.io/data/v1/guides/gemini-cli.json","title":"Getting Started with Gemini CLI","tagline":"Google's terminal coding agent — still shipping, but since June 2026 it no longer opens to a free Google account.","archetype":"prompts","last_reviewed_at":"2026-09-08","changelog_url":"https://geminicli.com/docs/changelogs/","how_it_works":"You open a text window on your computer, start it inside a project folder, and type what you want in plain English. It reads the files itself, proposes edits, runs commands to check its work, and asks before changing anything. You read what it did and say what to fix.","what_it_is":["Gemini CLI is Google's coding agent — AI that takes actions on its own rather than only answering — driven from a terminal, the text window where you type instructions instead of clicking. It works on a whole project at once, not one file.","Since 18 June 2026 it no longer serves free personal Google accounts, or Google AI Pro and Ultra subscribers. Google moved individuals to a separate tool, Antigravity CLI, which is where a beginner should now start.","The software is alive: the code is public and releases ship most weeks. It just answers only to an organisation's Code Assist licence or a paid Gemini API key — a password that identifies your app and spends your money."],"before_you_start":["Settle access before you install. A personal Google account no longer works; the two live routes are a Gemini Code Assist Standard or Enterprise licence, bought per seat by an organisation, or a paid Gemini API key. Without one it installs fine and then refuses to answer.","There is no monthly price for an individual — a paid key bills you for what you use, so a heavy week has no ceiling until you set a budget yourself.","Expect Google's documentation to lag Google's product: the quota page still lists a free 1,000-requests-a-day tier, and the sign-in page still recommends a personal account. The banner above them is current; the pages beneath are not.","You need code on your own disk and enough comfort with a terminal to install a package. If not yet, Google's Gemini assistant in a browser writes and explains code with nothing to install."],"getting_set_up_safely":{"official_source":"Google's official Gemini CLI documentation","body":["Install from Google's own listing only — npx @google/gemini-cli, a global npm install -g @google/gemini-cli, or brew install gemini-cli. Lookalikes exist and third-party instructions run a version behind.","Keep it to one project folder whose changes are tracked. It edits real files and runs real programs."],"vendor_docs_url":"https://geminicli.com/docs/"},"security":[{"kind":"text","text":"Nothing runs on your own hardware. Every request leaves your machine for Google's models, so a codebase you are barred from sharing is barred from this too."},{"kind":"list","label":"Which door you came in decides your data terms","items":["On a paid Gemini API key, Google's terms say it does not use your prompts or responses to improve its products. On the unpaid tier the same terms say the opposite, and that human reviewers may read them. The tool never tells you which you are on.","It also sends usage statistics by default — which tools ran, which model, how long, though Google states not the content of your prompts. One setting turns that off: privacy.usageStatisticsEnabled: false in ~/.gemini/settings.json."]}],"triad":{"best_at":["Reading a project you did not write and explaining how it fits together","Changes that touch several files and must stay consistent","Working from a picture — app-from-an-image-or-PDF is Google's own headline claim"],"okay_at":["Costing what you expect, since the bill tracks how long a session stays open, not the size of the task","Being learnable from what is written about it, since most guides predate the June change"],"avoid":["Its own setup pages, which still recommend the sign-in Google switched off in June","Depending on a free Google developer tier; this one ended a month after it was announced"]},"starter_actions":[{"title":"Work out which door is open to you, before you install","what_it_does":"Checks whether you hold a Gemini Code Assist Standard or Enterprise licence, or a Gemini API key with billing switched on; if neither, installs Antigravity CLI instead.","why_here":"Claude Code's entry check is one question — is your plan paid. Here the sign-in Google's own docs recommend is still there and still fails, so the only check that holds is what you own: a Code Assist licence, or a key with billing on. If it is neither, Antigravity CLI is where Google now sends you.","tweak":null,"prompt":null},{"title":"Hand it a picture instead of a description","what_it_does":null,"why_here":"The @ prefix pastes a file straight into the prompt with no upload step, and app-from-an-image is the line Google leads with — not where Claude Code or Cursor put their emphasis.","tweak":null,"prompt":"@mockup.png Build a single plain HTML and CSS page matching this layout, then list the three things you had to guess."},{"title":"Write a GEMINI.md in the project root","what_it_does":null,"why_here":"Context files load in a hierarchy — home folder, then workspace, then more as it touches directories — so a project file applies every session, and the filename setting takes a list, so a conventions file you already have can be reused.","tweak":"Keep it short. Every session pays for it whether it needs it or not.","prompt":"Read this project and draft a GEMINI.md: what it is, how to run its tests, the conventions you can infer, and three things never to change without asking me."}],"pitfalls":["Nearly every Gemini CLI guide online opens with the free personal-account login it no longer has.","A Google AI Pro or Ultra subscription does not cover it — it did until 18 June 2026, and the CLI simply stopped answering it."],"where_to_next":[{"label":"Other AI coding tools","url":"https://www.launchpadhq.io/discover?category=ai-coding-development"},{"label":"Google's assistant in a browser","url":"https://www.launchpadhq.io/discover?category=text-conversational-ai"},{"label":"Build with an API directly","url":"https://www.launchpadhq.io/discover?category=ai-apis-developer-services"}],"tool":{"slug":"gemini-cli","name":"Gemini CLI","url":"https://www.launchpadhq.io/platform/gemini-cli","data_url":"https://www.launchpadhq.io/data/v1/tools/gemini-cli.json","category":{"slug":"ai-coding-development","name":"AI Coding & Development"},"cost_tier":"FREE","lifecycle":"active","free_tier":{"available":true,"summary":"Free and open-source; uses free Gemini API tier (1,000 requests/day)"},"starting_price":"Free","lowest_paid":null,"data_as_of":null},"prices_removed":0,"pricing_note":"Prices in this text come from the catalog, the same data as each tool's page and its record (tool.starting_price, tool.lowest_paid, and plans in /data/v1/tools/{slug}.json). Any sentence that typed a price by hand is removed; prices_removed counts them.","generated_at":"2026-10-27T01:59:10.872Z","sponsored":false,"attribution":"Data from Launchpad HQ (https://www.launchpadhq.io). Please credit Launchpad HQ and link to the tool's Launchpad HQ page."}