docs: update to include gemini

Signed-off-by: Chojan Shang <chojan.shang@vesoft.com>

Author: Chojan Shang

README.md

@@ -1,3 +1,7 @@
+<a href="https://agentclientprotocol.com/" >
+  <img alt="Agent Client Protocol" src="https://zed.dev/img/acp/banner-dark.webp">
+</a>
+
 # Agent Client Protocol (Python)
 
 Python SDK for the Agent Client Protocol (ACP). Build agents that speak ACP over stdio so tools like Zed can orchestrate them.
@@ -10,6 +14,7 @@ Python SDK for the Agent Client Protocol (ACP). Build agents that speak ACP over
 - Async base classes and JSON-RPC plumbing that keep stdio agents tiny
 - Process helpers such as `spawn_agent_process` for embedding agents and clients directly in Python
 - Batteries-included examples that exercise streaming updates, file I/O, and permission flows
+- Optional Gemini CLI bridge (`examples/gemini.py`) for the `gemini --experimental-acp` integration
 
 ## Install
 
@@ -124,13 +129,33 @@ Full example with streaming and lifecycle hooks lives in [examples/echo_agent.py
 - `examples/client.py`: interactive console client that can launch any ACP agent via stdio
 - `examples/agent.py`: richer agent showcasing initialization, authentication, and chunked updates
 - `examples/duet.py`: launches both example agent and client using `spawn_agent_process`
+- `examples/gemini.py`: connects to the Gemini CLI in `--experimental-acp` mode, with optional auto-approval and sandbox flags
 
 ## Documentation
 
 - Project docs (MkDocs): https://psiace.github.io/agent-client-protocol-python/
 - Local sources: `docs/`
   - [Quickstart](docs/quickstart.md)
 
+## Gemini CLI bridge
+
+Want to exercise the `gemini` CLI over ACP? The repository includes a Python replica of the Go SDK's REPL:
+
+```bash
+python examples/gemini.py --yolo  # auto-approve permissions
+python examples/gemini.py --sandbox --model gemini-2.5-pro
+```
+
+Defaults assume the CLI is discoverable via `PATH`; override with `--gemini` or `ACP_GEMINI_BIN=/path/to/gemini`.
+
+The smoke test (`tests/test_gemini_example.py`) is opt-in to avoid false negatives when the CLI is unavailable or lacks credentials. Enable it locally with:
+
+```bash
+ACP_ENABLE_GEMINI_TESTS=1 ACP_GEMINI_BIN=/path/to/gemini uv run python -m pytest tests/test_gemini_example.py
+```
+
+The test gracefully skips when authentication prompts (e.g. missing `GOOGLE_CLOUD_PROJECT`) block the interaction.
+
 ## Development workflow
 
 ```bash

docs/index.md

@@ -1,3 +1,7 @@
+<a href="https://agentclientprotocol.com/" >
+  <img alt="Agent Client Protocol" src="https://zed.dev/img/acp/banner-dark.webp">
+</a>
+
 # Agent Client Protocol SDK (Python)
 
 Welcome to the Python SDK for the Agent Client Protocol (ACP). The package ships ready-to-use transports, typed protocol models, and examples that stream messages to ACP-aware clients such as Zed.
@@ -7,7 +11,7 @@ Welcome to the Python SDK for the Agent Client Protocol (ACP). The package ships
 - Pydantic models generated from the upstream ACP schema (`acp.schema`)
 - Async agent/client wrappers with JSON-RPC task supervision built in
 - Process helpers (`spawn_agent_process`, `spawn_client_process`) for embedding ACP nodes inside Python applications
-- Examples that showcase streaming updates, file operations, and permission flows
+- Examples that showcase streaming updates, file operations, permission flows, and even a Gemini CLI bridge (`examples/gemini.py`)
 
 ## Getting started
 
@@ -23,6 +27,22 @@ Welcome to the Python SDK for the Agent Client Protocol (ACP). The package ships
 
 Prefer a guided tour? Head to the [Quickstart](quickstart.md) for terminal, editor, and programmatic launch walkthroughs.
 
+## Gemini CLI bridge
+
+If you have access to the Gemini CLI (`gemini --experimental-acp`), run:
+
+```bash
+python examples/gemini.py --yolo
+```
+
+Flags mirror the Go SDK example:
+
+- `--gemini /path/to/cli` or `ACP_GEMINI_BIN` to override discovery
+- `--model`, `--sandbox`, `--debug` forwarded verbatim
+- `--yolo` auto-approves permission prompts with sensible defaults
+
+An opt-in smoke test lives at `tests/test_gemini_example.py`. Enable it with `ACP_ENABLE_GEMINI_TESTS=1` (and optionally `ACP_GEMINI_TEST_ARGS`) when the CLI is authenticated; otherwise the test stays skipped.
+
 ## Documentation map
 
 - [Quickstart](quickstart.md): install, run, and embed the echo agent, plus next steps for extending it

docs/quickstart.md

@@ -106,3 +106,21 @@ Hook it up with `AgentSideConnection` inside an async entrypoint and wire it to
 - [`examples/echo_agent.py`](https://github.com/psiace/agent-client-protocol-python/blob/main/examples/echo_agent.py) for the smallest streaming agent
 - [`examples/agent.py`](https://github.com/psiace/agent-client-protocol-python/blob/main/examples/agent.py) for an implementation that negotiates capabilities and streams richer updates
 - [`examples/duet.py`](https://github.com/psiace/agent-client-protocol-python/blob/main/examples/duet.py) to see `spawn_agent_process` in action alongside the interactive client
+- [`examples/gemini.py`](https://github.com/psiace/agent-client-protocol-python/blob/main/examples/gemini.py) to drive the Gemini CLI (`--experimental-acp`) directly from Python
+
+## 5. Optional: Talk to the Gemini CLI
+
+If you have the Gemini CLI installed and authenticated:
+
+```bash
+python examples/gemini.py --yolo                # auto-approve permission prompts
+python examples/gemini.py --sandbox --model gemini-1.5-pro
+```
+
+Environment helpers:
+
+- `ACP_GEMINI_BIN` — override the CLI path (defaults to `PATH` lookup)
+- `ACP_GEMINI_TEST_ARGS` — extra flags forwarded during the smoke test
+- `ACP_ENABLE_GEMINI_TESTS=1` — opt-in toggle for `tests/test_gemini_example.py`
+
+Authentication hiccups (e.g. missing `GOOGLE_CLOUD_PROJECT`) are surfaced but treated as skips during testing so the suite stays green on machines without credentials.