docs: remove stale gemini-acp references (#8572)

Signed-off-by: Michael Neale <michael.neale@gmail.com>
This commit is contained in:
Michael Neale 2026-04-16 12:34:41 +10:00 committed by GitHub
parent 19ce336a36
commit d3881897a1
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 9 additions and 86 deletions

View file

@ -12,7 +12,7 @@ goose supports [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) a
ACP providers pass goose [extensions](/docs/getting-started/using-extensions) through to the agent as MCP servers, so the agent can call your extensions directly.
:::tip Use Your Existing Subscriptions
ACP providers let you use goose with your existing Claude Code, ChatGPT Plus/Pro, or Google Gemini subscriptions — no per-token API costs. They are the recommended replacement for the deprecated [CLI providers](/docs/guides/cli-providers).
ACP providers let you use goose with your existing Claude Code or ChatGPT Plus/Pro subscriptions — no per-token API costs. They are the recommended replacement for the deprecated [CLI providers](/docs/guides/cli-providers).
:::
:::warning Limitations
@ -50,15 +50,6 @@ Wraps [codex-acp](https://github.com/zed-industries/codex-acp), an ACP adapter f
- Active ChatGPT Plus/Pro subscription or OpenAI API credits
- Authenticated with your OpenAI account (`codex` CLI working)
### Gemini ACP
Uses Google's [Gemini CLI](https://github.com/google-gemini/gemini-cli) directly via its native `--acp` flag. No shim needed — Gemini CLI speaks ACP natively. Replaces the deprecated `gemini-cli` CLI provider.
**Requirements:**
- Node.js and npm
- Gemini CLI installed (`npm install -g @google/gemini-cli`)
- Authenticated with your Google account (run `gemini` once to authenticate via browser)
### Pi ACP
Wraps `pi-acp`, an ACP adapter for Pi. Uses your existing Pi installation.
@ -169,42 +160,6 @@ Wraps `pi-acp`, an ACP adapter for Pi. Uses your existing Pi installation.
│ gpt-5.2-codex
```
### Gemini ACP
1. **Install Gemini CLI**
```bash
npm install -g @google/gemini-cli
```
2. **Authenticate with Google**
Run `gemini` once and follow the browser-based authentication flow.
3. **Configure goose**
Set the provider environment variable:
```bash
export GOOSE_PROVIDER=gemini-acp
```
Or configure through the goose CLI using `goose configure`:
```bash
┌ goose-configure
◇ What would you like to configure?
│ Configure Providers
◇ Which model provider should we use?
│ Gemini CLI (ACP)
◇ Model fetch complete
◇ Enter a model from that provider:
│ default
```
### Pi ACP
1. **Install the Pi CLI and ACP adapter**
@ -248,12 +203,6 @@ GOOSE_PROVIDER=codex-acp goose run \
-t 'Search for flights from BKI to SYD tomorrow'
```
```bash
GOOSE_PROVIDER=gemini-acp goose run \
--with-extension 'npx -y @modelcontextprotocol/server-everything' \
-t 'Use the echo tool to say hello'
```
## Configuration Options
### Amp ACP Configuration
@ -313,25 +262,6 @@ See [claude-agent-acp](https://github.com/zed-industries/claude-agent-acp) for s
See [codex-acp](https://github.com/zed-industries/codex-acp) for approval policy and sandbox details.
### Gemini ACP Configuration
| Environment Variable | Description | Default |
|----------------------|---------------------|-------------|
| `GOOSE_PROVIDER` | Set to `gemini-acp` | None |
| `GOOSE_MODEL` | Model to use | `default` |
| `GOOSE_MODE` | Permission mode | `auto` |
**Permission Modes (`GOOSE_MODE`):**
| Mode | Gemini Mode | Behavior |
|-----------------|-------------|---------------------------------------------------------------|
| `auto` | `yolo` | Auto-approves all tool calls |
| `smart-approve` | `auto_edit` | Auto-approves file edits, prompts for other operations |
| `approve` | `default` | Prompts for all permission-required operations |
| `chat` | `plan` | Planning only, no tool execution |
See the [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli) for approval mode details.
### Pi ACP Configuration
| Environment Variable | Description | Default |
@ -344,7 +274,7 @@ See the [Gemini CLI documentation](https://github.com/google-gemini/gemini-cli)
ACP providers depend on external binaries, so ensure:
- The ACP agent binary is installed and in your PATH (`amp-acp`, `claude-agent-acp`, `codex-acp`, `gemini`, `pi-acp`, or `copilot`)
- The ACP agent binary is installed and in your PATH (`amp-acp`, `claude-agent-acp`, `codex-acp`, `pi-acp`, or `copilot`)
- The underlying CLI tool is authenticated and working
- Subscription limits are not exceeded
- Node.js and npm are installed (for npm-distributed adapters)

View file

@ -8,7 +8,7 @@ description: Use Claude Code, Codex, Cursor Agent, or Gemini CLI subscriptions i
# CLI Providers
:::warning Deprecated — Use ACP Providers
The Claude Code (`claude-code`), Codex (`codex`), and Gemini CLI (`gemini-cli`) providers are deprecated. Use the [ACP providers](/docs/guides/acp-providers) (`claude-acp`, `codex-acp`, `gemini-acp`) instead, which support goose extensions via MCP and use the standardized Agent Client Protocol. CLI providers are kept for backward compatibility only.
The Claude Code (`claude-code`), Codex (`codex`), and Gemini CLI (`gemini-cli`) providers are deprecated. Use the [ACP providers](/docs/guides/acp-providers) (`claude-acp`, `codex-acp`) instead, which support goose extensions via MCP and use the standardized Agent Client Protocol. For Gemini, use the `Gemini` (`gemini_oauth`) provider which authenticates via OAuth. CLI providers are kept for backward compatibility only.
:::
goose can make use of pass-through providers that integrate with existing CLI tools from Anthropic, OpenAI, Cursor, and Google. These providers allow you to use your existing Claude Code, Codex, Cursor Agent, and Google Gemini CLI subscriptions through goose's interface, adding session management, persistence, and workflow integration capabilities to these tools.