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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ozeranskiihttptap.svg)](https://yunodb.com/tools/ozeranskiihttptap?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ozeranskiihttptap?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ozeranskiihttptap.svg" alt="Featured on YunoDB" height="20"></a>