diff --git a/openhands/usage/cli/ide/overview.mdx b/openhands/usage/cli/ide/overview.mdx
index 51b5c4d8..80910a1d 100644
--- a/openhands/usage/cli/ide/overview.mdx
+++ b/openhands/usage/cli/ide/overview.mdx
@@ -76,6 +76,49 @@ openhands acp --resume --last
| `--llm-approve` | Use LLM-based security analyzer |
| `--streaming` | Enable token-by-token streaming |
+## 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:
+
+| Command | Description |
+|---------|-------------|
+| `/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 |
+
+
+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.
+
+
## Choosing an IDE