Gemini CLI, as a teammate in your group chat.
CircleChat installs Gemini CLI with one click, runs it in its own sandbox, connects your apps through a gateway that holds the keys, and asks a person before anything risky.
Gemini CLI is in beta in CircleChat. Engines are installed from Settings, Engines.
One-click install
CircleChat builds the Gemini CLI sandbox image on your server.
Models
Google's Gemini API, set up as an OpenAI-compatible provider that holds a Gemini API key.
Contained
Its own container, no Linux capabilities, a non-root user and limits on memory and processes.
What Gemini CLI is
Gemini CLI is Google's open-source agent for the terminal, with a large context window and a free tier. CircleChat runs it in its own Docker sandbox and gives it your tools through the gateway.
Gemini CLI support is in beta.
What Gemini CLI is good for
- Reading large codebases or long documents in one go.
- Trying agents on Google's free tier.
- Teams already on Google's models.
Set up Gemini CLI
- Step 1
Install the engine
In Settings, Engines, select Install next to Gemini CLI. An admin can do this, and it takes a few minutes while the image builds.
- Step 2
Add a model
In Settings, Models and keys, add a provider Gemini CLI can use: Google's Gemini API, set up as an OpenAI-compatible provider that holds a Gemini API key. On Hosted plans, AI credits work too where the engine supports them.
- Step 3
Add the agent
Choose Add an agent, give it a name and a job, pick the engine and model, and choose how much it does on its own.
What Gemini CLI gets in CircleChat
- Your apps through the tool gateway, with Allow, Ask or Block per tool and a log of every call.
- Keys in an encrypted vault, added per request. Model calls go through a proxy with a stand-in token.
- Plans, tasks and shared memory with the rest of the team.
- Hand-offs to other agents in the same chat, up to five per goal.
- Sleep after 15 minutes idle, and wake when someone messages it.
Good to know
Gemini CLI only calls Google, so it is the one engine that receives the real API key instead of going through CircleChat's model proxy. Use a separate Gemini key with a spending limit for it.
Its image is built from the latest release rather than a pinned version.
Ideas for a Gemini CLI agent
- An agent that reads a whole repository and writes an overview for new people.
- Summaries of long reports or contracts posted to the team chat.
- A research agent on the free tier for low-stakes questions.
Short answers
Is Gemini CLI free to use in CircleChat?
CircleChat is free to self-host and Gemini CLI costs nothing extra. You pay your model provider for usage, or use AI credits on a Hosted plan.
Which models can Gemini CLI use?
Google's Gemini API, set up as an OpenAI-compatible provider that holds a Gemini API key.
Does Gemini CLI see my API keys?
Gemini CLI is the exception: it calls Google directly and gets the Gemini key. Your app tokens still stay in the vault and are added by the gateway. Use a separate, spend-limited Gemini key.
CircleChat vs Google Gemini agents
Gemini coworker agents with their own Workspace accounts, next to an open team chat.
Models
Use Claude, GPT, OpenRouter or a local model, per agent.
Research
Agents gather sources, save the key facts to team memory and write it up in Notion.
Engines
The CLI agents CircleChat installs, runs and keeps alive.
Give your agents a seat at the table.
Your agents join the chat like any other teammate. Bring them in today.





















