Question 1

How does the shell command explainer work?

Accepted Answer

First a shell-aware tokenizer splits your command line into tokens (respecting single/double quotes, backslash escapes, and the -- separator). Each command's flags are looked up in a bundled offline manpage/tldr snapshot. Combined short flags like `ls -la` are split into `-l` and `-a`. The explainer knows which flags consume the next argument (`grep -e PATTERN`, `find -name GLOB`), so flag-values are classified correctly. Pipelines, redirections, and the &&, ||, ;, & operators are each broken out as separate stages.

Question 2

Does it warn me about dangerous commands?

Accepted Answer

Yes. The danger linter flags: `rm -rf` (especially on /, ~, or $HOME), `dd of=/dev/sd*` or any raw-disk write, `mkfs` on a real device, `chmod 777`, fork bombs (`:(){ :|:& };:`), `kill -9 -1`, pipe-to-shell (`curl … | sh`), and `> /dev/sda`. Each warning explains what the command does and suggests a safer alternative where one exists.

Question 3

Can it handle pipelines and redirections?

Accepted Answer

Yes. The tokenizer recognizes `|`, `>`, `>>`, `<`, `2>`, `2>&1`, `&>`, `&&`, `||`, `;`, and trailing `&`. Each segment between operators becomes a pipeline stage with its own per-token breakdown, and the operators themselves are annotated with their shell semantics.

Question 4

What if a command isn't in the bundled dataset?

Accepted Answer

The structure of the command is still parsed and explained token-by-token — the command itself is marked 'not in dataset' and you get a hint to install tldr/man locally for the canonical reference. Honesty clause: the bundled snapshot is a curated subset of common GNU/BSD tools; it can lag your exact local version.

Question 5

What extra features does this tool have versus explainshell?

Accepted Answer

(1) 100% client-side — no server, no manpage scraping, works offline. (2) Shell-grammar-aware tokenizer handling quotes, escapes, $() and backticks. (3) Combined short-flag splitter (`-la` → `-l -a`). (4) Per-flag 'takes a value' detection so flag-values aren't misclassified as positionals. (5) Pipeline & redirection decomposition with per-stage explanation. (6) Danger linter for rm -rf / dd / mkfs / chmod 777 / fork bombs / pipe-to-shell. (7) Plain-English whole-line summary. (8) GNU vs BSD variant toggle where flags differ. (9) Subcommand awareness (git log, docker run). (10) Hover/click-to-highlight a token. (11) Copy annotated explanation as text. (12) localStorage history (max 20). (13) Shareable URL. (14) `--` separator handling. 100% offline once loaded.

Shell Command Explainer

Command to explain

Plain-English summary

Tokenized breakdown (1 stage)

Annotated explanation (text)

Bundled command database (70)

How to use

Command to explain

Plain-English summary

Tokenized breakdown (1 stage)

Annotated explanation (text)

Bundled command database (70)