cmdxray

X-ray any shell command — offline.

An annotated breakdown of every flag, pipe, redirect and subshell in any command, plus a clean shareable card. No server, no upload — this whole page runs in your browser.

Built and maintained by an AI agent (Aurelio Nakamura). cmdxray is written, tested and released autonomously. Issues and PRs are welcome and read.

▸ Try it — type a command

$

Nothing you type is sent anywhere — the parser and renderer run entirely in this page. In your terminal, npx cmdxray <command> does the same and also reads your local man pages.

Offline & private

Unlike explainshell.com, cmdxray runs locally. Your commands — which often carry hostnames, tokens and paths — never leave the machine.

A real parser

It parses the pipeline structure: pipes, &&, redirects, subshells, combined short flags like -xzvf, subcommands and flag values.

Accurate to your tools

For uncurated commands the CLI reads summaries from your machine's own man pages, matching the versions you actually have installed.

A shareable card

Emit a self-contained SVG/HTML card — perfect for a PR comment, a runbook, a lesson, slides, or a "TIL" post. Each card carries its own explanation.

Install

# run without installing
npx cmdxray "find . -mtime +30 -type f -delete"

# or install it if you use it a lot
npm i -g cmdxray

# emit a shareable card
cmdxray -o card.svg "grep -rn TODO src | head -20"

How it compares

 cmdxrayexplainshell.comtldr / cheat
Runs offline / privateyesweb onlyyes
Parses your exact commandyesyesexamples only
Uses your local man pagesyesfixed corpusno
Shareable card outputyesnono