March 3, 2026
Curl, but make it make sense
Show HN: Explain Curl Commands
Finally, a translator for those cryptic command lines—love it or hate it
TLDR: A new tool explains curl commands step by step, locally, turning obscure terminal magic into plain English. Commenters split between “read the manual” hardliners and fans who love the visual timeline and privacy-first approach—making this a lightning rod for usability vs purism debates.
Show HN dropped a new toy: “explain-my-curl,” a local-first tool that translates those scary terminal incantations into plain English. It breaks down what’s happening step by step—domain lookup (DNS), the security handshake (TLS), and the actual web request (HTTP)—with a split-screen interface and secret redaction for safety. Newcomers cheered, calling it a friendly flashlight for the command-line cave, while privacy hawks applauded the local-only telemetry. But purists pounced, waving the “just read the manual” flag and shouting that curl -v already shows everything. The drama centered on whether this is real help or hand-holding. Some argued the timeline and “Observed vs Inferred” labels bring much-needed transparency; others snarked that it’s just pretty packaging for seasoned pros. Jokes flew fast: “Finally, a curl whisperer,” “My curl therapist says I have trust issues,” and “Ctrl+B toggles vibes.” The TUI’s keyboard gymnastics drew laughs and side-eyes, while the project’s “transparency contract” got both applause and eye-rolls—either thoughtful ethics or theatrical flair. Whether you’re debugging weird API calls or learning how the internet handshake works, the crowd agreed on one thing: this explainer makes the invisible visible—and that’s either genius or a gateway drug to UI drama.
Key Points
- •explain-my-curl is a local-first CLI and TUI that parses and explains curl commands across DNS, TCP, TLS, and HTTP.
- •It provides execution telemetry for DNS resolution, TCP connect, TLS handshake, and time-to-first-byte, with secret redaction for displays and errors.
- •The project uses evidence labels (Observed, Inferred, Estimated) and includes a transparency contract in documentation.
- •Quick start instructions and TUI controls are provided, enabling interactive exploration and diagnostics.
- •Releases are automated with GoReleaser via GitHub Actions, with CI testing and cross-platform binaries for macOS, Linux, and Windows on amd64 and arm64, plus a Homebrew formula.