refactor: finish moving ssh-* scripts to own installers

[webi-installers/.git] / curlie / README.md

diff --git a/curlie/README.md b/curlie/README.md
index 8739aa494f2bfa88f4e9379681b33ccd7d3dd1a7..df79a51458afb38c132d5f9a33a8c810dd39878d 100644 (file)
--- a/curlie/README.md
+++ b/curlie/README.md
@@ -5,13 +5,8 @@ tagline: |
   curlie wraps `curl` with modern defaults and `httpie`-like syntax highlighting
 ---
 
-## Updating
-
-```bash
-webi curlie@stable
-```
-
-Use the `@beta` tag for pre-releases.
+To update or switch versions, run `webi curlie@stable` (or `@v1.6`, `@beta`,
+etc).
 
 ## Cheat Sheet
 
@@ -25,19 +20,19 @@ Use the `@beta` tag for pre-releases.
 
 **JSON** (`=`) is the default encoding for `key=value` pairs.
 
-## Simple GET
+### Simple GET
 
 ```bash
 curlie -v example.com
 ```
 
-## POST simple JSON with headers
+### POST simple JSON with headers
 
 ```bash
 curlie -v POST httpbin.org/status/201 "Authorization: Bearer xxxx" "name=John Doe"
 ```
 
-## POST large JSON
+### POST large JSON
 
 ```bash
 curlie -v POST httpbin.org/status/201 "Authorization: Bearer xxxx" -d '
@@ -48,3 +43,13 @@ curlie -v POST httpbin.org/status/201 "Authorization: Bearer xxxx" -d '
 ]
 '
 ```
+
+### Spoof Host and SNI
+
+The `--resolve` option is for when you need to test a local service as if it had
+a remote hostname and TLS SNI (or when you want to break things 😈).
+
+```bash
+curlie https://foo.example.com:8443 "Host: foo.example.com" \
+    --resolve foo.example.com:8443:127.0.0.1
+```