CURLIE(1)

📦 version 1.8.2, in ubuntu stonking

✨ CURLIE(1) ✨

User Commands · the curlie manual page · bestie edition 🎀

🌸 NAME 🌸

curlie — curl frontend with httpie-like interface and JSON formatting

Like, it's curl but it understood ✨aesthetics✨? Obsessed.

🦋 SYNOPSIS 🦋

curlie [CURL_OPTIONS...] [METHOD] URL [ITEM [ITEM...]]

💖 DESCRIPTION 💖

okay so. curlie is a frontend to curl(1) that combines the power and ubiquity of curl with the ease of use and human-friendly interface of httpie(1). Every single curl option is exposed, no compromise on features, no compromise on performance — but with syntax sugar and output formatting inspired by httpie on top. it's giving glow-up, fr fr. 💅

When you run it interactively, curlie gives you pretty-printed, colorized JSON output. Headers go to stderr and the body goes to stdout, so it plays nice with pipes and redirects. and the output is not buffered — all the formatting happens on the fly, which means you can inspect streamed data as it arrives. main character behavior honestly. 🫶

ngl, the headers-to-stderr thing is the kind of detail that just works with your shell scripts. iykyk.

👑 OPTIONS 👑

🔐 Authentication

  • --anyauth — pick any authentication method. dealer's choice, bestie ✨
  • --aws-sigv4 provider1[:prvdr2[:reg[:srv]]] — use AWS V4 signature authentication.
  • --basic — use HTTP Basic Authentication.
  • --digest — use HTTP Digest Authentication.
  • --negotiate — use HTTP Negotiate (SPNEGO) authentication.
  • -n, --netrc — read username and password from .netrc.
  • --netrc-file filename — specify FILE for netrc.
  • --netrc-optional — use either .netrc or URL.
  • --ntlm — use HTTP NTLM authentication.
  • --oauth2-bearer token — specify OAuth 2 Bearer Token.
  • -u, --user user:password — set server user and password.

🧚 TLS / SSL

  • --ca-native — load CA certs from the OS.
  • --cacert file — CA certificate to verify peer against.
  • --capath dir — CA directory to verify peer against.
  • -E, --cert certificate[:password] — client certificate file and password.
  • --cert-status — verify server certificate status via OCSP stapling.
  • --cert-type type — certificate type (DER/PEM/ENG/PROV/P12).
  • --ciphers list — TLS 1.2 (and earlier) ciphers to use.
  • -k, --insecure — allow insecure server connections.
  • --key key — private key filename.
  • --key-type type — private key file type (DER/PEM/ENG).
  • --ssl — try enabling TLS.
  • --ssl-reqd — require SSL/TLS.
  • -1, --tlsv1 — use TLSv1.0 or greater.
  • --tlsv1.0 — use TLSv1.0 or greater.
  • --tlsv1.1 — use TLSv1.1 or greater.
  • --tlsv1.2 — use TLSv1.2 or greater.
  • --tlsv1.3 — use TLSv1.3 or greater.
  • --tls-max VERSION — set the maximum allowed TLS version.
  • --tls13-ciphers list — TLS 1.3 cipher suites to use.
bestie pls do not casually -k/--insecure on anything that matters. it's literally insecure. 🔥

💜 HTTP Request

  • -d, --data data — send HTTP POST data.
  • --data-ascii data — send HTTP POST ASCII data.
  • --data-binary data — send HTTP POST binary data.
  • --data-raw data — send HTTP POST data, '@' allowed.
  • --data-urlencode data — send HTTP POST data URL encoded.
  • -F, --form name=content — specify multipart MIME data.
  • --form-string name=string — specify multipart MIME data as string.
  • -G, --get — put post data in the URL and use GET.
  • -H, --header header/@file — pass custom header(s) to server.
  • -I, --head — show document info only (HEAD request).
  • --http1.0 — use HTTP/1.0.
  • --http1.1 — use HTTP/1.1.
  • --http2 — use HTTP/2.
  • --http3 — use HTTP/3.
  • --json data — send HTTP POST JSON data.
  • -X, --request method — specify the request method to use.
  • -A, --user-agent name — send User-Agent to server.

🌈 HTTP Response

  • --compressed — request a compressed response.
  • -D, --dump-header filename — write the received headers to a file.
  • -f, --fail — fail fast with no output on HTTP errors.
  • --fail-with-body — fail on HTTP errors but save the body.
  • -L, --location — follow redirects.
  • --max-redirs num — set the maximum number of redirects allowed.
  • -i, --show-headers — show response headers in output.

🎀 Output

  • --curl — print the underlying curl command being executed.
  • -o, --output file — write output to file instead of stdout.
  • --output-dir dir — directory to save files in.
  • --pretty — force pretty-printed output.
  • -#, --progress-bar — display transfer progress as a bar.
  • -s, --silent — silent mode.
  • -v, --verbose — make the operation more talkative.
  • -w, --write-out format — output FORMAT after completion.

🦋 Connection

  • --connect-timeout seconds — maximum time allowed to connect.
  • --connect-to HOST1:PORT1:HOST2:PORT2 — connect to host2 instead of host1.
  • --dns-servers addresses — DNS server addresses to use.
  • --doh-url URL — resolve hostnames over DNS-over-HTTPS.
  • -4, --ipv4 — resolve names to IPv4 addresses only.
  • -6, --ipv6 — resolve names to IPv6 addresses only.
  • -m, --max-time seconds — maximum time allowed for the transfer.
  • --no-keepalive — disable TCP keepalive on the connection.
  • --resolve [+]host:port:addr[,addr]... — resolve host+port to a specific address.
  • --retry num — retry request if transient problems occur.
  • --tcp-fastopen — use TCP Fast Open.
  • --unix-socket path — connect through this Unix domain socket.

🌸 Proxy

  • -x, --proxy [protocol://]host[:port] — use this proxy.
  • -U, --proxy-user user:password — set proxy user and password.
  • -p, --proxytunnel — use HTTP proxy tunnel (via CONNECT).
  • --socks4 host[:port] — use SOCKS4 proxy on given host and port.
  • --socks5 host[:port] — use SOCKS5 proxy on given host and port.

⭐ Transfer

  • -C, --continue-at offset — resume transfer at given offset.
  • --limit-rate speed — limit transfer speed to RATE.
  • -O, --remote-name — write output to file named as remote file.
  • -T, --upload-file file — transfer local FILE to destination.
  • -Z, --parallel — perform transfers in parallel.
  • --parallel-max num — maximum concurrency for parallel transfers.

🍓 Cookies

  • -b, --cookie data|filename — send cookies from string or load from file.
  • -c, --cookie-jar filename — save cookies to file after operation.
  • -j, --junk-session-cookies — ignore session cookies read from file.

🙈 Miscellaneous

  • -K, --config file — read configuration from a file.
  • -q, --disable — disable .curlrc.
  • -h, --help subject — get help for commands.
  • -M, --manual — display the full manual.
  • -V, --version — show version number and quit.

🔥 EXAMPLES 🔥

Simple GET request with pretty-printed JSON response:

curlie https://httpbin.org/get

POST request with JSON data using key=value syntax:

curlie POST https://httpbin.org/post name=debian version=1

PUT request with a custom header and JSON body:

curlie PUT https://httpbin.org/put X-Token:secret name=curlie

Send raw JSON data:

curlie POST https://httpbin.org/post --json '{"key":"value"}'

HEAD request to inspect response headers only:

curlie -I https://httpbin.org/get

Follow redirects and show response headers:

curlie -L -i https://httpbin.org/redirect/1

Use Basic Authentication:

curlie --basic -u user:password https://httpbin.org/basic-auth/user/password

Print the underlying curl command without executing:

curlie --curl POST https://httpbin.org/post name=test

Download a file saving it with the remote filename:

curlie -O https://example.com/file.tar.gz

Send a request through a SOCKS5 proxy:

curlie --socks5 localhost:1080 https://httpbin.org/get

💀 SEE ALSO 💀

curl(1), httpie(1), wget(1)

the holy trinity, honestly. go read them too, bestie. 🫶

💅 AUTHOR 💅

Olivier Poitrey <rs@dailymotion.com>

This manual page was written for the Debian project by Josenilson Ferreira da Silva <nilsonfsilva@hotmail.com>.

and that's the whole page babes ✨ — curlie, manual page dated 2025-12-07, page id CURLIE(1), straight from the User Commands section. slay, have fun curling, and remember: headers to stderr, body to stdout, no buffering, no problems. periodt. 💖

📦 where this page comes from