explain-my-curl

explain-my-curl est un CLI local-first pour comprendre ce que fait une commande curl à travers DNS, TLS et HTTP.

Ce dépôt inclut actuellement :

• Une commande CLI pour analyser et expliquer une entrée curl
• Un TUI de démarrage pour une exploration interactive
• De la télémétrie d'exécution pour DNS, connexion TCP, handshake TLS et time-to-first-byte
• Une fonction de masquage des secrets pour l'affichage des commandes et les chaînes d'erreur
• Des étiquettes de preuve (Observed, Inferred, Estimated) pour soutenir la transparence du protocole
• Un contrat de transparence dans docs/transparency-contract.md

Quick Start

go mod tidy
go run ./cmd/explain-my-curl explain "curl https://example.com -I"
go run ./cmd/explain-my-curl tui
go run ./cmd/explain-my-curl doctor
go run ./cmd/explain-my-curl version

Contrôles du TUI

• Enter : exécuter la commande curl saisie
• Esc : passer en mode inspection
• Tab : basculer le focus entre saisie et inspection
• i : focus sur le mode saisie
• j/k ou touches fléchées : déplacer l'étape sélectionnée de la chronologie
• Space : réduire/développer l'étape sélectionnée de la chronologie
• Ctrl+R : basculer le panneau de diagnostic de la réponse
• Ctrl+B : basculer la prévisualisation du corps de la réponse
• q : quitter

Versions

• Les versions taguées (v*) sont construites automatiquement avec GoReleaser via GitHub Actions.
• L'IC valide go test ./... sur les pushes et les pull requests.
• L'IC exécute également une compilation snapshot GoReleaser pour vérifier en continu la configuration de publication.
• Les artefacts sont publiés pour macOS/Linux/Windows sur amd64 et arm64.
• Les binaires des versions incluent les métadonnées de construction intégrées (version, commit, date).
• Une formule Homebrew est générée dans Formula/ lors de la publication (le tap utilise ce même dépôt).

État actuel

La télémétrie d'exécution locale, le TUI à deux volets, le masquage des secrets, les tests, le contrat de transparence et l'automatisation des versions sont en place.