Skip to content

Document ACP Confirmation Modes and Slash Commands #164

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xingyaoww merged 3 commits into from
Feb 19, 2026
Merged

Document ACP Confirmation Modes and Slash Commands #164

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
d181c59
Document ACP confirmation modes and slash commands
openhands-agent Dec 8, 2025
960c079
Merge main and add confirmation mode documentation to new location
openhands-agent Feb 10, 2026
b66ead5
Merge branch 'main' into openhands/acp-confirmation-mode-docs
malhotra5 Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 43 additions & 0 deletions openhands/usage/cli/ide/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@
CLI -->|Commands| Runtime[Sandbox Runtime]
```

1. Your IDE launches `openhands acp` as a subprocess

Check warning on line 46 in openhands/usage/cli/ide/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (allhandsai) - vale-spellcheck

openhands/usage/cli/ide/overview.mdx#L46 

Did you really mean 'subprocess'?
2. Communication happens via JSON-RPC 2.0 over stdio
3. OpenHands uses your configured LLM and runtime settings
4. Results are displayed in your IDE's interface
Expand Down Expand Up @@ -76,6 +76,49 @@
| `--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 |

<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>

## Choosing an IDE

<CardGroup cols={2}>
Expand Down