.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH XH "1" "June 2026" "xh 0.25.3" "User Commands"
.SH NAME
xh \- manual page for xh 0.25.3
.SH SYNOPSIS
.B xh
[\fI\,OPTIONS\/\fR] \fI\,<\/\fR[\fI\,METHOD\/\fR] \fI\,URL> \/\fR[\fI\,REQUEST_ITEM\/\fR]...
.SH DESCRIPTION
xh is a friendly and fast tool for sending HTTP requests
.SS "Arguments:"
.TP
<[METHOD] URL>
The request URL, preceded by an optional HTTP method
.TP
[REQUEST_ITEM]...
Optional key\-value pairs to be included in the request.
.SH OPTIONS
.HP
\fB\-j\fR, \fB\-\-json\fR
.IP
(default) Serialize data items from the command line as a JSON object
.HP
\fB\-f\fR, \fB\-\-form\fR
.IP
Serialize data items from the command line as form fields
.HP
\fB\-\-multipart\fR
.IP
Like \fB\-\-form\fR, but force a multipart/form\-data request even without
files
.HP
\fB\-\-raw\fR <RAW>
.IP
Pass raw request data without extra processing
.HP
\fB\-\-pretty\fR <STYLE>
.IP
Controls output processing [possible values: all, colors, format,
none]
.HP
\fB\-\-format\-options\fR <FORMAT_OPTIONS>
.IP
Set output formatting options
.HP
\fB\-s\fR, \fB\-\-style\fR <THEME>
.IP
Output coloring style [possible values: auto, solarized, monokai,
fruity]
.HP
\fB\-\-response\-charset\fR <ENCODING>
.IP
Override the response encoding for terminal display purposes
.HP
\fB\-\-response\-mime\fR <MIME_TYPE>
.IP
Override the response mime type for coloring and formatting for the
terminal
.HP
\fB\-p\fR, \fB\-\-print\fR <FORMAT>
.IP
String specifying what the output should contain
.HP
\fB\-h\fR, \fB\-\-headers\fR
.IP
Print only the response headers. Shortcut for \fB\-\-print\fR=\fI\,h\/\fR
.HP
\fB\-b\fR, \fB\-\-body\fR
.IP
Print only the response body. Shortcut for \fB\-\-print\fR=\fI\,b\/\fR
.HP
\fB\-m\fR, \fB\-\-meta\fR
.IP
Print only the response metadata. Shortcut for \fB\-\-print\fR=\fI\,m\/\fR
.HP
\fB\-v\fR, \fB\-\-verbose\fR...
.IP
Print the whole request as well as the response
.HP
\fB\-\-debug\fR
.IP
Print full error stack traces and debug log messages
.HP
\fB\-\-all\fR
.IP
Show any intermediary requests/responses while following redirects
with \fB\-\-follow\fR
.HP
\fB\-P\fR, \fB\-\-history\-print\fR <FORMAT>
.IP
The same as \fB\-\-print\fR but applies only to intermediary
requests/responses
.HP
\fB\-q\fR, \fB\-\-quiet\fR...
.IP
Do not print to stdout or stderr
.HP
\fB\-S\fR, \fB\-\-stream\fR
.IP
Always stream the response body
.HP
\fB\-x\fR, \fB\-\-compress\fR...
.IP
Content compressed (encoded) with Deflate algorithm
.HP
\fB\-o\fR, \fB\-\-output\fR <FILE>
.IP
Save output to FILE instead of stdout
.HP
\fB\-d\fR, \fB\-\-download\fR
.IP
Download the body to a file instead of printing it
.HP
\fB\-c\fR, \fB\-\-continue\fR
.IP
Resume an interrupted download. Requires \fB\-\-download\fR and \fB\-\-output\fR
.HP
\fB\-\-session\fR <FILE>
.IP
Create, or reuse and update a session
.HP
\fB\-\-session\-read\-only\fR <FILE>
.IP
Create or read a session without updating it from the request/response
exchange
.HP
\fB\-A\fR, \fB\-\-auth\-type\fR <AUTH_TYPE>
.IP
Specify the auth mechanism [possible values: basic, bearer, digest]
.HP
\fB\-a\fR, \fB\-\-auth\fR <USER[:PASS] | TOKEN>
.IP
Authenticate as USER with PASS (\fB\-A\fR basic|digest) or with TOKEN (\fB\-A\fR
bearer)
.HP
\fB\-\-ignore\-netrc\fR
.IP
Do not use credentials from .netrc
.HP
\fB\-\-offline\fR
.IP
Construct HTTP requests without sending them anywhere
.HP
\fB\-\-check\-status\fR
.IP
(default) Exit with an error status code if the server replies with an
error
.HP
\fB\-F\fR, \fB\-\-follow\fR
.IP
Do follow redirects
.HP
\fB\-\-max\-redirects\fR <NUM>
.IP
Number of redirects to follow. Only respected if \fB\-\-follow\fR is used
.HP
\fB\-\-timeout\fR <SEC>
.IP
Connection timeout of the request
.HP
\fB\-\-proxy\fR <PROTOCOL:URL>
.IP
Use a proxy for a protocol. For example: \fB\-\-proxy\fR
https:http://proxy.host:8080
.HP
\fB\-\-verify\fR <VERIFY>
.IP
If "no", skip SSL verification. If a file path, use it as a CA bundle
.HP
\fB\-\-cert\fR <FILE>
.IP
Use a client side certificate for SSL
.HP
\fB\-\-cert\-key\fR <FILE>
.IP
A private key file to use with \fB\-\-cert\fR
.HP
\fB\-\-ssl\fR <VERSION>
.IP
Force a particular TLS version [possible values: auto, tls1, tls1.1,
tls1.2, tls1.3]
.HP
\fB\-\-https\fR
.IP
Make HTTPS requests if not specified in the URL
.HP
\fB\-\-http\-version\fR <VERSION>
.IP
HTTP version to use [possible values: 1.0, 1.1, 2, 2\-prior\-knowledge,
3\-prior\-knowledge]
.HP
\fB\-\-resolve\fR <HOST:ADDRESS>
.IP
Override DNS resolution for specific domain to a custom IP
.HP
\fB\-\-interface\fR <NAME>
.IP
Bind to a network interface or local IP address
.HP
\fB\-4\fR, \fB\-\-ipv4\fR
.IP
Resolve hostname to ipv4 addresses only
.HP
\fB\-6\fR, \fB\-\-ipv6\fR
.IP
Resolve hostname to ipv6 addresses only
.HP
\fB\-\-unix\-socket\fR <FILE>
.IP
Connect using a Unix domain socket
.HP
\fB\-I\fR, \fB\-\-ignore\-stdin\fR
.IP
Do not attempt to read stdin
.HP
\fB\-\-curl\fR
.IP
Print a translation to a curl command
.HP
\fB\-\-curl\-long\fR
.IP
Use the long versions of curl's flags
.HP
\fB\-\-generate\fR <KIND>
.IP
Generate shell completions or man pages
.HP
\fB\-\-help\fR
.IP
Print help
.HP
\fB\-V\fR, \fB\-\-version\fR
.IP
Print version
.PP
Each option can be reset with a \fB\-\-no\-OPTION\fR argument.
.PP
Run "xh help" for more complete documentation.
.PP
\fB\-native\-tls\fR +rustls