docs: Clarify architecture and rationale in project docs

Author: raphaelluethy

AGENTS.md

@@ -1,7 +1,7 @@
 # Repository Guidelines
 
 ## Project Structure & Module Organization
-Source lives in `src/`. Key modules include the ACP agent (`src/cursor-acp-agent.ts`), Cursor CLI integration (`src/cursor-cli-runner.ts`), protocol mapping (`src/cursor-event-mapper.ts`), and prompt conversion (`src/prompt-conversion.ts`). Tests are in `src/tests/` and use the `.test.ts` naming pattern. Build output is emitted to `dist/` and should not be edited by hand. Documentation and notes live in `docs/`.
+Source lives in `src/`. Key modules include the outer ACP agent (`src/cursor-acp-agent.ts`), the native `agent acp` bridge (`src/cursor-native-acp-client.ts`), Cursor CLI helpers (`src/cursor-cli-runner.ts`), and prompt conversion (`src/prompt-conversion.ts`). The adapter wraps Cursor's native `agent acp` backend and adds session persistence, history replay, model selection, and auto-approval of tool calls. Tests are in `src/tests/` and use the `.test.ts` naming pattern. Build output is emitted to `dist/` and should not be edited by hand. Documentation and notes live in `docs/`.
 
 ## Build, Test, and Development Commands
 - `bun install`: install dependencies.

README.md

@@ -1,14 +1,14 @@
 # cursor-acp
 
-Cursor now published their own acp client (finally :D): https://cursor.com/docs/cli/acp#ide-integrations
+> **Why does this exist?** Cursor published their own ACP client ([docs](https://cursor.com/docs/cli/acp#ide-integrations)), but using it in Zed was rough as I somehow had to permit tool calls the whole time.
 
 Disclaimer: I am not affiliated with Cursor or Zed. This project is a personal experiment and should not be considered an official product of either company. I am a big fan of both products and wanted to combine what I like with both of them: An amazing editor and a great AI coding agent (and composer-1, holy this model flies xD).
 
 An [Agent Client Protocol (ACP)](https://github.com/agentclientprotocol/agent-client-protocol) adapter for [Cursor](https://cursor.com) Agent CLI, enabling Cursor's AI coding assistant to be used within [Zed](https://zed.dev) and other ACP-compatible clients.
 
 ## About
 
-This is an `ai-assisted` personal project aimed at bringing Cursor's agent into Zed. It now acts as a **wrapper around native `agent acp`**, while preserving compatibility features that the current native ACP server does not expose yet.
+This is an `ai-assisted` personal project aimed at bringing Cursor's agent into Zed. It acts as a **wrapper around native `agent acp`**, auto-approving tool calls when you opt in and preserving compatibility features that the current native ACP server does not expose yet.
 
 **Based on [claude-code-acp](https://github.com/zed-industries/claude-code-acp)** by Zed Industries - the original ACP adapter for Claude Code that served as the architectural foundation for this project.