Skip to content
Docs

Gemini CLI

Set Gemini CLI up with one line in your terminal: it installs the CLI, teaches Gemini CLI Basemodo and signs you in.

Set up

In your terminal, on macOS and Linux:

Terminal window
curl -fsSL https://basemodo.com/install | sh

On Windows, in PowerShell:

Terminal window
irm https://basemodo.com/install.ps1 | iex

It installs the basemodo command, then runs basemodo setup: it asks whether your agents should know Basemodo in every project (press Enter) or only in the folder your terminal is in, finds the agents on your computer and writes Basemodo's Skills where each reads them, then opens your browser to sign you in. Running the line again updates the CLI and the Skills.

Gemini CLI reads the Skills from ~/.agents/skills, or from the project's .agents/skills when you chose this project only. Start a new Gemini CLI session and ask it, for example: "Deploy this folder to Basemodo and give me the link." It runs the CLI and deploys the folder it works in, with no GitHub repository needed.

Other ways

Use one way in Gemini CLI: the install line above, or one of these. Each gives it every command of Basemodo (the Plugin through the Remote MCP), so with two it sees every command twice (one way per client).

The Plugin

Basemodo's Skills and its Remote MCP in one install, without the CLI, from basemodocom/agent, as a Gemini CLI extension:

Terminal window
gemini extensions install https://github.com/basemodocom/agent

Then sign in to its Remote MCP with /mcp auth basemodo, as below.

The Remote MCP

Terminal window
gemini mcp add --transport http --scope user basemodo https://mcp.basemodo.com

Then sign in: in a Gemini CLI session, run /mcp auth basemodo. Your browser opens on basemodo.com, which asks you to approve Gemini CLI. Approve it, and Gemini CLI acts as you through its Agent Grant. Gemini CLI finds Basemodo's sign-in and registers itself, so there is nothing else to configure. Its deploy takes a GitHub repository, not a folder.

--scope user adds Basemodo to ~/.gemini/settings.json, for every project. Without it, it goes to the current project's .gemini/settings.json.

The local MCP

The same tools on your computer, basemodo mcp. With basemodo installed (curl -fsSL https://basemodo.com/install | sh on macOS and Linux, irm https://basemodo.com/install.ps1 | iex in Windows' PowerShell) and signed in with basemodo login:

Terminal window
gemini mcp add --scope user basemodo basemodo mcp

What it needs

Gemini CLI signed in with a Gemini Code Assist license (Standard or Enterprise) or a Gemini API key. Since June 18, 2026, it no longer serves free, Google AI Pro or Google AI Ultra individual accounts, which Google moved to Antigravity CLI.