httptap
Rich-powered CLI that breaks each HTTP request into DNS, connect, TLS, wait, and transfer phases with waterfall timelines, compact summaries, or metrics-only ou
What is httptap?
Rich-powered CLI that breaks each HTTP request into DNS, connect, TLS, wait, and transfer phases with waterfall timelines, compact summaries, or metrics-only output.
Overview of httptap
What it is
httptap is a rich-powered CLI that dissects an HTTP request into every meaningful phase—DNS, TCP connect, TLS handshake, server wait, and body transfer—and renders the results as a timeline table, compact summary, or machine-friendly metrics. It is designed for interactive troubleshooting, regression analysis, and recording of performance baselines.
Key features
- Phase-by-phase timing built from httpcore trace hooks with sane fallbacks when metal-level data is unavailable.
- All HTTP methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS with request body support.
- IPv4/IPv6 aware: the resolver and TLS inspector report both the address and its family; -4/-6 flags restrict resolution to one family, and --resolve pins a host to an address while keeping the original Host header and TLS SNI.
- TLS insights: certificate CN, SANs, issuer, serial, validity window and expiry countdown, plus cipher suite and protocol version, captured automatically from the live connection.
- Multiple output modes: rich waterfall view, compact single-line summaries, or --metrics-only for scripting.
- JSON and HAR export: persist full step data (including redirect chains) or stream to stdout; HAR 1.2 archive for browser DevTools.
- SLO threshold checking: --slo total=500,ttfb=200 (or thresholds from a file with --slo-file) gates CI jobs, cron probes, and readiness checks on per-phase latency budgets; non-zero exit on violation while still rendering the full report.
Use cases
Interactive troubleshooting, regression analysis, and recording of performance baselines. Scripted baselines with structured JSON output.
Getting started
shellpip install httptapOr using Homebrew on macOS/Linux:shellbrew install httptapOr using uvx (recommended):shelluvx --from 'httptap[completion]' httptap https://example.com
License and pricing
License: Apache-2.0. Open source.
Based on the project's public README and repository metadata.