httpstat for Mac

httpstat visualizes curl(1) statistics in a way of beauty and clarity.

It is a single file? Python script that has no dependency? and is compatible with Python 3?.

Features Beautiful terminal output — timing breakdown of DNS, TCP, TLS, server processing, and content transfer Structured JSON output — --format json / jsonl for machine consumption with a stable v1 schema SLO threshold checking — --slo total=500,connect=100 exits with code 4 on violation Save results to file — --save path.json for multi-step workflows NO_COLOR support — respects the NO_COLOR convention Agent skill — built-in skill for agent-assisted HTTP performance diagnostics

Installation

There are three ways to get httpstat: Download the script directly: wget https://raw.githubusercontent.com/reorx/httpstat/master/httpstat.py Through pip: pip install httpstat Through homebrew (macOS only): brew install httpstat For Windows users, @davecheney's Go version is suggested. → download link

Skills

httpstat ships with an agent skill that teaches AI coding assistants (Claude Code, Cursor, etc.) how to use httpstat for HTTP performance diagnostics — automatic installation, bottleneck identification, and actionable fix suggestions.

Install the skill into your project:

Once installed, your agent will automatically use httpstat when you ask questions like "why is this API slow?" or "debug this endpoint's latency".

Usage

Simply:

If installed through pip or brew, you can use httpstat as a command:

cURL Options

Because httpstat is a wrapper of cURL, you can pass any cURL supported option after the url (except for -w, -D, -o, -s, -S which are already used by httpstat):

Structured Output

Use --format (-f) to get machine-readable output:

Use --format jsonl for compact single-line JSON (useful for log pipelines).

SLO Thresholds

Check response times against thresholds. Exits with code 4 on violation:

Supported keys: total, connect, ttfb (time to first byte), dns, tls.

In pretty mode, violations are printed in red at the end of the output. In JSON mode, violations appear in the slo field:

Save Results

Write structured JSON output to a file (works with any --format):

Environment Variables

httpstat has a bunch of environment variables to control its behavior. Here are some usage demos, you can also run httpstat --help to see full explanation. HTTPSTAT_SHOW_BODY

Set to true to show response body in the output, note that body length is limited to 1023 bytes, will be truncated if exceeds. Default is false. HTTPSTAT_SHOW_IP

By default httpstat shows remote and local IP/port address. Set to false to disable this feature. Default is true. HTTPSTAT_SHOW_SPEED

Set to true to show download and upload speed. Default is false. HTTPSTAT_SAVE_BODY

By default httpstat stores body in a tmp file, set to false to disable this feature. Default is true HTTPSTAT_CURL_BIN

Indicate the cURL bin path to use. Default is curl from current shell $PATH.