docs: warn about keyring hang in unattended ACP environments (#12173)

This commit is contained in:
Abhijay Jain
2026-09-29 01:31:47 +00:00
committed by GitHub
parent 4dea9b483e
commit 7b72e902a3
@@ -716,6 +716,16 @@ goose acp
This command is automatically invoked by ACP-compatible clients and is not typically run directly by users. The client manages the lifecycle of the `goose acp` process. See [Using goose in ACP Clients](/docs/gdk/acp) for details.
:::
:::warning Unattended environments
goose uses the system keyring by default. On macOS, reading a credential may display a Keychain authorization prompt. If your ACP client runs goose without a user available to respond, keyring access can block indefinitely.
Disable keyring access for that process and provide provider credentials through environment variables:
```bash
GOOSE_DISABLE_KEYRING=1 OPENAI_API_KEY='...' goose acp
```
:::
---
#### serve [options]