docs: document all super-man modes in README

Add ask/task/category/explain/ai modes and requirements to the usage
section, matching the script's actual --help output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
leetcrypt
2026-06-08 16:29:11 -07:00
parent 34dc19a8b4
commit 0c6b871713
+13 -4
View File
@@ -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.