diff --git a/README.md b/README.md
index 9e52588..62ce48e 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,15 @@
 
 Blockers are for real damage or clear wrong turns: destructive commands, secret leaks, pushing broken code, ignoring explicit instructions, going in circles. Concerns cover likely bugs, wrong assumptions, unverified claims, or a much better approach.
 
+## Picking the advisor in the composer
+
+The plugin adds an **Advisor** control to the composer bar, next to the model picker:
+- **Off**: no reviews.
+- **Same model as the agent**: the default.
+- **Any model from DSH's model picker**: the same provider-grouped list. **Hover** a model that has reasoning efforts to open a side menu and pick its effort; clicking the model uses its default effort. The keyboard works too (→ opens the effort menu, ← goes back, Esc closes).
+
+The trigger shows the current choice, e.g. `Claude Haiku · Low` or `Advisor off`. The choice is saved on the host (`<profile>/omp-advisor.json`, through `GET`/`POST /omp-advisor/settings`). It applies from the advisor's next review, with no restart, and it overrides `enabled`, `provider`, `model` and `reasoningEffort` from the config below. Picking an advisor never changes the agent's own model.
+
 ## Installation
 
 ```bash