# super-man

An interactive, fuzzy command + man-page flag browser for the terminal. Search
260+ commands, drill into any one to fuzzy-search its flags with live
descriptions, and jump back to the command list instantly.

## Demo

![super-man demo](demo/super-man-demo.gif)

Video (MP4): [`demo/super-man-demo.mp4`](demo/super-man-demo.mp4) ·
asciinema cast: [`demo/super-man-demo.cast`](demo/super-man-demo.cast)

The clip shows opening an entry (`grep`), browsing its flags, then pressing
**Esc** to return straight to the home screen — no intermediary step — and
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
```

`Esc` in the flag browser returns to the command list; `Esc` on the home screen
exits.

See [`docs/`](docs/) for design notes and the full feature history.