explain-my-curl

explain-my-curl은 cURL 명령어가 DNS, TLS, HTTP에서 수행하는 작업을 이해할 수 있도록 도와주는 로컬 우선 CLI 도구입니다.

이 저장소는 현재 다음을 포함합니다:

• cURL 입력을 파싱하고 설명하는 CLI 명령어
• 대화형 탐색을 위한 스타터 TUI
• DNS, TCP 연결, TLS 핸드셰이크, 최초 응답 시간(Time-to-first-byte)에 대한 실행 텔레메트리
• 명령어 표시 및 오류 문자열에 대한 비밀 정보 삭제(Secret redaction)
• 프로토콜 투명성을 지원하는 증거 레이블 (Observed, Inferred, Estimated)
• docs/transparency-contract.md에 있는 투명성 계약

빠른 시작

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 조작 방법

• Enter: 현재 cURL 입력 실행
• Esc: 검사 모드로 전환
• Tab: 입력/검사 포커스 전환
• i: 입력 모드에 포커스
• j/k 또는 방향키: 선택된 타임라인 단계 이동
• Space: 선택된 타임라인 단계 접기/펼치기
• Ctrl+R: 응답 진단 패널 전환
• Ctrl+B: 응답 본문 미리보기 표시 전환
• q: 종료

릴리스

• 태그된 릴리스(v*)는 GitHub Actions를 통해 GoReleaser로 자동 빌드됩니다.
• CI는 푸시 및 풀 리퀘스트에서 go test ./...를 검증합니다.
• CI는 또한 GoReleaser 스냅샷 빌드를 실행하여 릴리스 구성을 지속적으로 확인합니다.
• 아티팩트는 macOS/Linux/Windows의 amd64 및 arm64용으로 게시됩니다.
• 릴리스 바이너리에는 빌드 메타데이터(version, commit, date)가 포함됩니다.
• 릴리스 중에 Homebrew 포뮬러가 Formula/에 생성됩니다(tap은 이 저장소를 사용합니다).

현재 상태

로컬 실행 텔레메트리, 분할 패널 TUI, 비밀 정보 삭제, 테스트, 투명성 계약 및 릴리스 자동화가 마련되어 있습니다.