explain-my-curl

explain-my-curl ist ein primär lokales CLI zum Verständnis dessen, was ein curl-Befehl über DNS, TLS und HTTP tut.

Dieses Repository enthält derzeit:

• Ein CLI-Befehl zum Parsen und Erklären einer curl-Eingabe
• Eine Starter-TUI zur interaktiven Erkundung
• Ausführungstelemetrie für DNS, TCP-Verbindung, TLS-Handshake und Zeit bis zum ersten Byte
• Geheimnis-Schwärzung für Befehlsanzeige und Fehlerstrings
• Nachweiskennzeichnungen (Observed, Inferred, Estimated) zur Unterstützung der Protokolltransparenz
• Ein Transparenzvertrag in 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

TUI Controls

• Enter: aktuellen curl-Befehl ausführen
• Esc: in den Inspektionsmodus wechseln
• Tab: Fokus zwischen Eingabe/Inspektion wechseln
• i: Eingabemodus fokussieren
• j/k oder Pfeiltasten: ausgewählten Zeitschritt bewegen
• Space: ausgewählten Zeitschritt einklappen/ausklappen
• Ctrl+R: Antwortdiagnose-Bereich umschalten
• Ctrl+B: Sichtbarkeit der Antworttextvorschau umschalten
• q: beenden

Releases

• Getaggte Releases (v*) werden automatisch mit GoReleaser über GitHub Actions erstellt.
• CI validiert go test ./... bei Pushes und Pull-Requests.
• CI führt auch einen GoReleaser-Snapshot-Build durch, um die Release-Konfiguration kontinuierlich zu überprüfen.
• Artefakte werden für macOS/Linux/Windows auf amd64 und arm64 veröffentlicht.
• Release-Binärdateien enthalten eingebettete Build-Metadaten (version, commit, date).
• Ein Homebrew-Formel wird während des Releases in Formula/ generiert (Tap verwendet dieses selbe Repository).

Current Status

Lokale Ausführungstelemetrie, Split-Pane-TUI, Schwärzung, Tests, Transparenzvertrag und Release-Automatisierung sind vorhanden.