explain-my-curl

explain-my-curl é um CLI local-first para entender o que um comando curl está fazendo em DNS, TLS e HTTP.

Este repositório atualmente inclui:

• Um comando CLI para analisar e explicar uma entrada curl
• Uma TUI inicial para exploração interativa
• Telemetria de execução para DNS, conexão TCP, handshake TLS e tempo até o primeiro byte
• Redação de segredos para exibição de comandos e strings de erro
• Rótulos de evidência (Observed, Inferred, Estimated) para apoiar a transparência do protocolo
• Um contrato de transparência em docs/transparency-contract.md

Início 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 da TUI

• Enter: executar a entrada curl atual
• Esc: alternar para modo de inspeção
• Tab: alternar foco entre entrada/inspeção
• i: focar no modo de entrada
• j/k ou teclas de seta: mover etapa da linha do tempo selecionada
• Space: recolher/expandir etapa da linha do tempo selecionada
• Ctrl+R: alternar painel de diagnóstico de resposta
• Ctrl+B: alternar visibilidade da pré-visualização do corpo da resposta
• q: sair

Lançamentos

• Lançamentos com tags (v*) são construídos automaticamente com GoReleaser via GitHub Actions.
• CI valida go test ./... em pushes e pull requests.
• CI também executa uma construção snapshot do GoReleaser para verificar continuamente a configuração de lançamento.
• Artefatos são publicados para macOS/Linux/Windows em amd64 e arm64.
• Binários de lançamento incluem metadados de construção incorporados (version, commit, date).
• Uma fórmula Homebrew é gerada em Formula/ durante o lançamento (o tap usa este mesmo repositório).

Status Atual

Telemetria de execução local, TUI com painéis divididos, redação, testes, contrato de transparência e automação de lançamentos estão implementados.