diff --git a/docs/agents.md b/docs/agents.md
index e5caf19f..ff11b1bf 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -207,6 +207,9 @@ Interactive mode provides human-in-the-loop control over the research process th
 # Start interactive research mode
 haiku-rag research --interactive
 
+# Start with a specific question
+haiku-rag research --interactive "How does X work?"
+
 # With document filter
 haiku-rag research --interactive --filter "uri LIKE '%report%'"
 ```
diff --git a/docs/cli.md b/docs/cli.md
index 3e0edf0f..ad59fcd9 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -183,10 +183,24 @@ Filter to specific documents:
 haiku-rag research "What are the key findings?" --filter "uri LIKE '%paper%'"
 ```
 
+Interactive mode with human-in-the-loop:
+
+```bash
+# Start interactive research mode
+haiku-rag research --interactive
+
+# Start with a specific question
+haiku-rag research --interactive "How does haiku.rag work?"
+
+# With document filter
+haiku-rag research --interactive --filter "uri LIKE '%docs%'"
+```
+
 Flags:
 
 - `--verbose`: Show planning, searching previews, evaluation summary, and stop reason
 - `--filter`: SQL WHERE clause to filter documents (see [Filtering Search Results](python.md#filtering-search-results))
+- `--interactive` / `-i`: Start interactive research mode with human-in-the-loop decision points
 
 Research parameters like `max_iterations`, `confidence_threshold`, and `max_concurrency` are configured in your [configuration file](configuration/index.md) under the `research` section.