CLI

latency is a network instrument and a client for the platform in one static binary for macOS, Linux and Windows. It works without an account; signing in adds every readable platform endpoint as a command.

Install

curl -fsSL https://latency.app/install.sh | sh

Or with a Go toolchain: go install github.com/latency-labs/cli/cmd/latency@latest.

Instruments

latency example.com                 # waterfall: dns → tcp → tls → ttfb → transfer
latency https://api.example.com -p  # ...with an ICMP/TCP ping burst
latency ping 1.1.1.1 -c 10          # live samples; ICMP when the OS allows it, else TCP
latency dns example.com -t MX       # timed lookups over the OS, a resolver IP, or DoH
latency dns example.com --compare   # rank well-known resolvers by answer time

The waterfall reads the certificate chain, negotiated protocol (HTTP/2 via ALPN), redirect target and server from the real connection. --follow times the final hop, --insecure inspects self-signed targets, -4/-6 pin the address family.

Platform

The command tree is generated from /v1/resources, so every readable endpoint is a command with flags typed from its schema. latency resources lists them, latency <command> --help explains one.

latency inspect example.com
latency sre example.com                        # streamed diagnosis
latency telemetry search 'level:error' --since 1d
latency telemetry query p95 duration_ms --signal traces --by name
latency telemetry tail --stream api
tail -F /var/log/app.log | latency ingest --key lit_…
latency api catalog/detail -q slug=example     # raw escape hatch, any endpoint

Sign in with latency auth login you@example.com, or set LATENCY_TOKEN to an API key from Account in the console. latency config set namespace <slug> saves a default namespace.

Scripting

--json on any command emits machine-readable output. Exit codes are stable:

Code	Meaning
0	success
2	usage: bad flag, missing argument, rejected input
3	unauthorized: sign in or set LATENCY_TOKEN
4	network: target or platform unreachable
5	not found
6	timeout

latency completion <shell> prints shell completions.