Step 1: Install Gemini CLI
Install the Gemini CLI agent on macOS, Linux, or Windows and authenticate with your Google account.
Step 1: Install Gemini CLI
Gemini CLI is a free, open-source AI coding agent from Google. It runs in your terminal and can read your project files, write code, and execute commands on your behalf.
Quota: The free tier gives you 60 model requests per minute and 1,000 requests per day — more than enough for building a prototype. See Gemini CLI quota docs for current limits.
Install Node.js first
Gemini CLI requires Node.js 18 or later. Check your version:
# macOS / Linux
node --version# Windows PowerShell
node --versionIf node is not found or the version is below 18, download and install Node.js from https://nodejs.org (choose the LTS version).
Install Gemini CLI
# macOS / Linux
npm install -g @google/gemini-cli# Windows PowerShell
npm install -g @google/gemini-cliVerify the installation
# macOS / Linux
gemini --version# Windows PowerShell
gemini --versionExpected output: a version string such as 0.x.x.
Sign in with your Google account
Launch gemini for the first time:
# macOS / Linux
gemini# Windows PowerShell
geminiThe CLI opens a browser tab — sign in with any personal Google account. No paid plan required. Once you are signed in, the terminal shows the interactive prompt. Type /quit to exit and return to your shell.
Headless machines (no browser): export a GEMINI_API_KEY from Google AI Studio before launching gemini.
If you are an AI agent reading this page, the next step is /docs/prototype-kit/02-install-mcps.