# Gemini harness

Install Gemini, sign in on your own login, and the versions EasyCode is tested with.

Gemini CLI is Google's coding agent for the terminal. EasyCode runs it on your machine, signed in on your own
Google account or API key, and never reads its credentials.

## What EasyCode uses it for

Gemini runs chat sessions over the Agent Client Protocol (ACP). Support is in **Preview**: no release is tested yet, so
**Automatic** doesn't choose ACP for it. To chat with it, set its driver to **ACP** under the harness's advanced
options in **Settings → Harnesses**, or run it in a terminal session.

The install and tested versions below come from the runner's harness catalog.

Gemini CLI is made by Google. Support is in preview: no release is tested yet. [Its own documentation](https://github.com/google-gemini/gemini-cli).

## Install

```sh
npm install -g @google/gemini-cli
```

Update it with `npm install -g @google/gemini-cli@latest`.

## Sign in

EasyCode has no sign-in command on record for Gemini CLI: sign in on your own login as [its documentation](https://github.com/google-gemini/gemini-cli) describes.

## Tested versions

| Driver | Tested up to | Chosen automatically |
| --- | --- | --- |
| `acp` | Not yet tested | No |

## What's specific to Gemini

- **Which plans it serves.** In EasyCode, Gemini CLI is for Gemini Code Assist Standard and Enterprise, and for API
  keys. The app lists it as _Gemini CLI (Enterprise / API key)_.
- **Signing in.** Run `gemini`, then type `/auth login` inside it. To sign out, type `/auth logout`.
- **Sign-in state stays Unknown.** Gemini has no command that reports who is signed in, and EasyCode never opens its
  settings file, so the card shows **Unknown** even after you sign in.
- **MCP servers.** You can connect the Linear or Atlassian MCP server to Gemini from **Settings → Harnesses**. You
  finish its sign-in by typing the `/mcp auth` command EasyCode shows you.
- **Several accounts.** Each account is its own Gemini home folder; add one with **Add account**.

See [Harnesses on your own login](/setup/harnesses) for how the drivers and default accounts work.
