From d181c59a7098992936ff867debcb17b0be44bfdf Mon Sep 17 00:00:00 2001
From: openhands <openhands@all-hands.dev>
Date: Mon, 8 Dec 2025 21:55:30 +0000
Subject: [PATCH] Document ACP confirmation modes and slash commands

- Update feature list to mark Confirmation Mode and Slash Commands as implemented
- Add comprehensive Confirmation Modes section explaining three modes:
  - Always Ask (default): user confirms each action
  - Always Approve: auto-approve all actions
  - LLM-Based Approval: intelligent risk-based approval
- Document CLI flags: --always-approve and --llm-approve
- Explain slash commands for changing modes during session (/confirm, /help)
- Add Zed IDE configuration example with mode flags
- Note that mode persists for session duration

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/run-openhands/acp.mdx | 73 ++++++++++++++++++++++++---
 1 file changed, 66 insertions(+), 7 deletions(-)

diff --git a/openhands/usage/run-openhands/acp.mdx b/openhands/usage/run-openhands/acp.mdx
index 69cff159..bee4c23f 100644
--- a/openhands/usage/run-openhands/acp.mdx
+++ b/openhands/usage/run-openhands/acp.mdx
@@ -31,16 +31,54 @@ OpenHands CLI currently supports the following ACP features:
 - Initialization - version negotiation and capability exchange
 - Session Setup - creating new sessions and loading existing ones
 - Content - including embedded content and resources
-- Prompt Turns - sending prompts and receiving responses (permissions coming soon)
+- Prompt Turns - sending prompts and receiving responses with permission support
 - Tool Calls - executing tools and returning results
 - Agent Plan - sharing agent's planned actions
-
-**🚧 Coming Soon:**
-- Confirmation - user authorization for tool calls
-- Slash Commands - for changing confirmation mode
+- Confirmation Mode - user authorization for tool calls and prompt turns
+- Slash Commands - for changing confirmation mode during a session
 
 Feel free to open issues on the [OpenHands-CLI repo](https://github.com/OpenHands/OpenHands-CLI/issues) if you have feature requests or encounter any problems.
 
+## Confirmation Modes
+
+OpenHands ACP supports three confirmation modes to control how agent actions are approved:
+
+### Always Ask (Default)
+
+The agent will request user confirmation before executing each tool call or prompt turn. This provides maximum control and safety.
+
+```bash
+openhands acp  # defaults to always-ask mode
+```
+
+### Always Approve
+
+The agent will automatically approve all actions without asking for confirmation. Use this mode when you trust the agent to make decisions autonomously.
+
+```bash
+openhands acp --always-approve
+```
+
+### LLM-Based Approval
+
+The agent uses an LLM-based security analyzer to evaluate each action. Only actions predicted to be high-risk will require user confirmation, while low-risk actions are automatically approved.
+
+```bash
+openhands acp --llm-approve
+```
+
+### Changing Modes During a Session
+
+You can change the confirmation mode during an active session using slash commands:
+
+- `/confirm always-ask` - Switch to always-ask mode
+- `/confirm always-approve` - Switch to always-approve mode
+- `/confirm llm-approve` - Switch to LLM-based approval mode
+- `/help` - Show all available slash commands
+
+<Note>
+The confirmation mode setting persists for the duration of the session but will reset to the default (or command-line specified mode) when you start a new session.
+</Note>
 
 ## ACP Integration
 
@@ -84,10 +122,31 @@ To configure OpenHands CLI with Zed:
 }
 ```
 
+<Tip>
+To use a different confirmation mode by default, add the mode flag to the `args` array:
+
+```json
+{
+  "agent_servers": {
+    "OpenHands": {
+      "command": "uvx",
+      "args": [
+        "openhands",
+        "acp",
+        "--always-approve"
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+Replace `--always-approve` with `--llm-approve` for LLM-based approval, or omit the flag to use the default always-ask mode.
+</Tip>
 
-4. Save the file
+5. Save the file
 
-5. You can now use OpenHands within Zed!
+6. You can now use OpenHands within Zed!
 
 ![Zed Use OpenHands Agent](/openhands/static/img/acp-zed-use-openhands.png)