diff --git a/README.md b/README.md
index dcfa6d4..b897f68 100644
--- a/README.md
+++ b/README.md
@@ -18,13 +18,22 @@ repeating with `tar`.
 ## Usage
 
 ```bash
-super-man                 # interactive home screen (fzf)
-super-man <command>       # jump straight to a command's flags
-super-man ask "<task>"    # natural-language task lookup
-super-man --list          # list all known commands
+super-man                       # interactive home screen (fzf)
+super-man <command> [filter]    # jump straight to a command's flags
+super-man -l, --list            # list all known commands
+super-man -h, --help            # full help
+
+# Natural-language modes (database-backed, needs jq)
+super-man ask "find large files"        # ask a question
+super-man task "monitor cpu usage"      # describe what you want to do
+super-man category files                # browse by category (files/text/network/system)
+super-man explain "tar -czf"            # explain what a command does
+super-man ai "count lines in js files"  # AI-powered NL2SH model (advanced)
 ```
 
 `Esc` in the flag browser returns to the command list; `Esc` on the home screen
 exits.
 
+**Requirements:** `jq` for the natural-language modes, `fzf` for interactive mode.
+
 See [`docs/`](docs/) for design notes and the full feature history.