explainshell

What it is

explainshell is a free website that takes a command line, such as tar -xzvf archive.tar.gz -C /tmp or find . -name "*.log" -mtime +7 -exec rm {} +, and explains each part. It matches every program and option against text drawn from manual pages and shows the relevant help next to each piece. It also understands shell syntax such as pipes, redirection and command substitution. The project is open source on GitHub.

Why it is useful

The command line rewards understanding and punishes guessing. Tutorials, Stack Overflow answers, READMEs and AI assistants all hand you commands to paste, and some of them are destructive or simply wrong for your situation. explainshell lets you check, in seconds, what each flag does before anything runs. It is also a good learning tool: reading the explanation for a command you use every day often reveals options you did not know existed.

How to use it

1. Copy the command you are unsure about.
2. Paste it into the box on the home page.
3. Hover over or read each highlighted part and its explanation.
4. If a part is not explained, check man or --help on your own machine, since versions differ.

Limitations

Explanations come from the manual pages the site has processed, so very new options, uncommon programs and some shell built-ins may be missing. The help text reflects GNU and Linux versions of tools, which can differ from the BSD versions on macOS. It explains; it does not tell you whether a command is safe for your files.

Is it worth it?

Yes, as a habit. Pair it with a rule: never run a command with sudo, rm -rf or a pipe into a shell until you can explain every part.

Common questions

Does it run the command? No. It only analyses the text you paste.

Is it free? Yes. The site is free and the code is open source.

Should I paste secrets into it? No. Remove tokens, passwords and private hostnames from a command before pasting it into any website.