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