explain-my-curl

explain-my-curl es un CLI local-first para entender lo que un comando curl está haciendo a través de DNS, TLS y HTTP.

Este repositorio actualmente incluye:

• Un comando CLI para analizar y explicar una entrada de curl
• Un TUI inicial para exploración interactiva
• Telemetría de ejecución para DNS, conexión TCP, handshake TLS y tiempo hasta el primer byte
• Redacción de secretos para la visualización de comandos y cadenas de error
• Etiquetas de evidencia (Observed, Inferred, Estimated) para apoyar la transparencia del protocolo
• Un contrato de transparencia en docs/transparency-contract.md

Inicio Rápido

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

Controles del TUI

• Enter: ejecutar la entrada curl actual
• Esc: cambiar al modo de inspección
• Tab: cambiar el foco entre entrada e inspección
• i: enfocar el modo de entrada
• j/k o teclas de flecha: mover el paso seleccionado de la línea de tiempo
• Espacio: colapsar/expandir el paso seleccionado de la línea de tiempo
• Ctrl+R: alternar el panel de diagnóstico de respuesta
• Ctrl+B: alternar la visibilidad de la vista previa del cuerpo de la respuesta
• q: salir

Lanzamientos

• Los lanzamientos etiquetados (v*) se construyen automáticamente con GoReleaser a través de GitHub Actions.
• CI valida go test ./... en pushes y pull requests.
• CI también ejecuta una compilación snapshot de GoReleaser para verificar la configuración de lanzamiento continuamente.
• Los artefactos se publican para macOS/Linux/Windows en amd64 y arm64.
• Los binarios de lanzamiento incluyen metadatos de compilación incrustados (version, commit, date).
• Se genera una fórmula de Homebrew en Formula/ durante el lanzamiento (el tap usa este mismo repositorio).

Estado Actual

La telemetría de ejecución local, el TUI de panel dividido, la redacción, las pruebas, el contrato de transparencia y la automatización de lanzamientos están implementados.