xh

Friendly, fast HTTP client for the terminal. Send requests with colorized output, built-in JSON support, and HTTPie compatibility.

50 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

HTTP Requests

Make requests

17commands

Authentication

Auth methods

6commands

Output

Response formatting

13commands

Sessions

Persistent sessions

11commands

Install xh (macOS)

$ brew install xh

Install xh HTTP client using Homebrew on macOS

Install xh (Linux)

$ sudo apt install xh -y

Install xh HTTP client using apt on Debian/Ubuntu

Check xh version

$ xh --version

Verify xh is installed and display the current version

Basic Auth

$ xh -a username:password GET https://api.example.com/protected

Use Basic Authentication.

Bearer token

$ xh -A bearer -a token123 GET https://api.example.com/users

Use Bearer token.

Authorization header

$ xh GET https://api.example.com Authorization:'Bearer token123'

Set Authorization header.

Digest Auth

$ xh -A digest -a user:pass GET https://api.example.com/protected

Use HTTP Digest Authentication.

Netrc auth

$ xh --auth-type=bearer --netrc GET https://api.example.com

Read credentials from .netrc file.

Prompt for password

$ xh -a username GET https://api.example.com/protected

Prompt for password interactively.

Headers only

$ xh --headers GET https://api.example.com

Show only response headers.

Body only

$ xh --body GET https://api.example.com

Show only response body.

Verbose

$ xh --verbose GET https://api.example.com

Show request and response.

Download file

$ xh --download GET https://example.com/file.zip

Download a file.

Print parts

$ xh --print=hb GET https://api.example.com

Print headers and body.

No colors

$ xh --style=plain GET https://api.example.com

Output without colors.

JSON output mode

$ xh --json POST https://api.example.com/data key=value

Force JSON content type for the request.

Pretty print

$ xh --pretty=all GET https://api.example.com/users

Pretty-print both headers and body.

Monokai theme

$ xh --style=monokai GET https://api.example.com

Use monokai color theme for output.

Check status for scripting

$ xh --check-status GET https://api.example.com/health

Exit with error code on 4xx/5xx responses.

Save output to file

$ xh --output=response.json GET https://api.example.com/data

Write response body to a file.

Resume download

$ xh --download --continue GET https://example.com/large-file.zip

Resume a partially completed download.

Print request only

$ xh --print=HB GET https://api.example.com

Print request headers (H) and body (B) only.

Create session

$ xh --session=api POST https://api.example.com/login user=admin

Create a named session.

Use session

$ xh --session=api GET https://api.example.com/protected

Use existing session.

Read-only session

$ xh --session-read-only=api GET https://api.example.com

Use session without saving.

Anonymous session

$ xh --session=/tmp/anon-session.json GET https://api.example.com

Use a file path for an anonymous session.

Session with auth

$ xh --session=myapi -a user:pass GET https://api.example.com/data

Store credentials in a named session.

Skip TLS verification

$ xh --verify=no GET https://self-signed.example.com

Disable TLS certificate verification.

Client certificate

$ xh --cert=client.pem --cert-key=key.pem GET https://api.example.com

Use a client TLS certificate for mutual TLS.

Use proxy

$ xh --proxy=https:http://proxy.example.com:8080 GET https://api.example.com

Route requests through an HTTP proxy.

Set timeout

$ xh --timeout=30 GET https://api.example.com/slow-endpoint

Set request timeout in seconds.

Force HTTP/2

$ xh --http-version=2 GET https://api.example.com

Use HTTP/2 for the request.

Default scheme shorthand

$ xh :3000/api/health

Shorthand for http://localhost:3000.

Discussion

Loading comments...

xh