docs: polish ACP docs (#7946)
Signed-off-by: Adrian Cole <adrian@tetrate.io>
This commit is contained in:
@@ -17,8 +17,10 @@ The client manages the goose lifecycle automatically, including:
|
||||
|
||||
- **Initialization**: The client runs the `goose acp` command to initialize the connection
|
||||
- **Communication**: The client communicates with goose over stdio using JSON-RPC
|
||||
- **Multiple Sessions**: The client manages multiple concurrent goose conversations simultaneously
|
||||
- **Session Isolation**: Each session maintains its own isolated state, including conversation history, agent context, and extension configurations, allowing concurrent sessions to run without interference
|
||||
- **Multiple Sessions**: The client manages multiple concurrent conversations, each with isolated state
|
||||
- **Model and Mode Switching**: The client can switch models and modes mid-session without restarting
|
||||
- **File Operations**: The client handles file reads and writes, so goose sees changes not yet saved to disk and edits show as native diffs
|
||||
- **Terminal**: The client runs commands in its own terminal, so output appears alongside the conversation
|
||||
|
||||
:::info Session Persistence
|
||||
ACP sessions are saved to goose's session history where you can access and manage them using goose. Access to session history in ACP clients might vary.
|
||||
@@ -42,7 +44,7 @@ Ensure you have both Zed and goose CLI installed:
|
||||
- **Zed**: Download from [zed.dev](https://zed.dev/)
|
||||
- **goose CLI**: Follow the [installation guide](/docs/getting-started/installation)
|
||||
|
||||
- ACP support works best with version 1.16.0 or later - check with `goose --version`.
|
||||
- Verify goose is installed: `goose --version`
|
||||
|
||||
- Temporarily run `goose acp` to test that ACP support is working:
|
||||
|
||||
|
||||
@@ -29,7 +29,7 @@ Wraps [claude-agent-acp](https://github.com/zed-industries/claude-agent-acp), an
|
||||
|
||||
### Codex ACP
|
||||
|
||||
Wraps [codex-acp](https://github.com/zed-industries/codex-acp), an ACP adapter for OpenAI's Codex. Uses the same ChatGPT subscription as the `codex` CLI provider. Codex's sandbox blocks network by default — goose automatically enables network access when HTTP MCP servers are configured.
|
||||
Wraps [codex-acp](https://github.com/zed-industries/codex-acp), an ACP adapter for OpenAI's Codex. Uses the same ChatGPT subscription as the `codex` CLI provider. Codex's sandbox blocks network by default; goose automatically enables network access when HTTP MCP servers are configured.
|
||||
|
||||
**Requirements:**
|
||||
- Node.js and npm
|
||||
@@ -142,6 +142,7 @@ GOOSE_PROVIDER=codex-acp goose run \
|
||||
|----------------------|---------------------|-----------|
|
||||
| `GOOSE_PROVIDER` | Set to `claude-acp` | None |
|
||||
| `GOOSE_MODEL` | Model to use | `default` |
|
||||
| `GOOSE_MODE` | Permission mode | `auto` |
|
||||
|
||||
**Known Models:**
|
||||
- `default` (opus)
|
||||
@@ -165,6 +166,7 @@ See [claude-agent-acp](https://github.com/zed-industries/claude-agent-acp) for s
|
||||
|----------------------|--------------------|-----------------|
|
||||
| `GOOSE_PROVIDER` | Set to `codex-acp` | None |
|
||||
| `GOOSE_MODEL` | Model to use | `gpt-5.2-codex` |
|
||||
| `GOOSE_MODE` | Permission mode | `auto` |
|
||||
|
||||
**Known Models:**
|
||||
- `gpt-5.2-codex`
|
||||
|
||||
Reference in New Issue
Block a user