Clean up README

Author: ammario

README.md

@@ -126,39 +126,15 @@ httpjail creates an isolated network environment for the target process, interce
 - macOS 10.15+ (Catalina or later)
 - No special permissions required (runs in weak mode)
 
-## Usage Examples
-
-### Basic Usage
-
-```bash
-# Simple allow/deny rules
-httpjail --js "r.host === 'api.github.com'" -- git pull
-
-# Multiple allow patterns using regex
-httpjail \
-  --js "/github\.com$/.test(r.host) || /githubusercontent\.com$/.test(r.host)" \
-  -- npm install
-
-# Deny telemetry while allowing everything else
-httpjail \
-  --js "!/telemetry\.|analytics\.|sentry\./.test(r.host)" \
-  -- ./application
-
-# Method-specific rules
-httpjail \
-  --js "(r.method === 'GET' && /api\..*\.com$/.test(r.host)) || (r.method === 'POST' && !/telemetry\./.test(r.host)) || r.method !== 'GET' && r.method !== 'POST'" \
-  -- ./application
-```
-
-### Configuration File
+## Configuration File
 
 Create a `rules.js` file with your JavaScript evaluation logic:
 
 ```javascript
 // rules.js
 // Allow GitHub GET requests, block telemetry, allow everything else
-(r.method === 'GET' && /github\.com$/.test(r.host)) ||
-(!/telemetry/.test(r.host))
+(r.method === "GET" && /github\.com$/.test(r.host)) ||
+  !/telemetry/.test(r.host);
 ```
 
 Use the config:
@@ -167,47 +143,7 @@ Use the config:
 httpjail --js-file rules.js -- ./my-application
 ```
 
-### Script-Based Evaluation
-
-Instead of writing JavaScript, you can use a custom script to evaluate each request. The script receives environment variables for each request and returns an exit code to allow (0) or block (non-zero) the request. Any output to stdout becomes additional context in the 403 response.
-
-```bash
-# Simple script example
-#!/bin/bash
-if [ "$HTTPJAIL_HOST" = "github.com" ] && [ "$HTTPJAIL_METHOD" = "GET" ]; then
-    exit 0  # Allow the request
-else
-    exit 1  # Block the request
-fi
-
-# Use the script
-httpjail --sh ./check_request.sh -- curl https://github.com
-
-# Inline script (with spaces, executed via shell)
-httpjail --sh '[ "$HTTPJAIL_HOST" = "github.com" ] && exit 0 || exit 1' -- git pull
-```
-
-If `--sh` has spaces, it's run through `sh`; otherwise it's executed directly.
-
-**Environment variables provided to the script:**
-
-- `HTTPJAIL_URL` - Full URL being requested
-- `HTTPJAIL_METHOD` - HTTP method (GET, POST, etc.)
-- `HTTPJAIL_HOST` - Hostname from the URL
-- `HTTPJAIL_SCHEME` - URL scheme (http or https)
-- `HTTPJAIL_PATH` - Path component of the URL
-
-**Script requirements:**
-
-- Exit code 0 allows the request
-- Any non-zero exit code blocks the request
-- stdout is captured and included in 403 responses as additional context
-- stderr is logged for debugging but not sent to the client
-
-> [!TIP]
-> Script-based evaluation can also be used for custom logging! Your script can log requests to a database, send metrics to a monitoring service, or implement complex audit trails before returning the allow/deny decision.
-
-### JavaScript (V8) Evaluation
+## JavaScript (V8) Evaluation
 
 httpjail includes first-class support for JavaScript-based request evaluation using Google's V8 engine. This provides flexible and powerful rule logic.
 
@@ -234,6 +170,7 @@ httpjail --js "(r.block_message = 'Social media blocked', !r.host.includes('face
 **JavaScript API:**
 
 All request information is available via the `r` object:
+
 - `r.url` - Full URL being requested (string)
 - `r.method` - HTTP method (GET, POST, etc.)
 - `r.host` - Hostname from the URL
@@ -259,7 +196,47 @@ All request information is available via the `r` object:
 > [!NOTE]
 > The `--js` flag conflicts with `--sh` and `--js-file`. Only one evaluation method can be used at a time.
 
-### Advanced Options
+## Script-Based Evaluation
+
+Instead of writing JavaScript, you can use a custom script to evaluate each request. The script receives environment variables for each request and returns an exit code to allow (0) or block (non-zero) the request. Any output to stdout becomes additional context in the 403 response.
+
+```bash
+# Simple script example
+#!/bin/bash
+if [ "$HTTPJAIL_HOST" = "github.com" ] && [ "$HTTPJAIL_METHOD" = "GET" ]; then
+    exit 0  # Allow the request
+else
+    exit 1  # Block the request
+fi
+
+# Use the script
+httpjail --sh ./check_request.sh -- curl https://github.com
+
+# Inline script (with spaces, executed via shell)
+httpjail --sh '[ "$HTTPJAIL_HOST" = "github.com" ] && exit 0 || exit 1' -- git pull
+```
+
+If `--sh` has spaces, it's run through `sh`; otherwise it's executed directly.
+
+**Environment variables provided to the script:**
+
+- `HTTPJAIL_URL` - Full URL being requested
+- `HTTPJAIL_METHOD` - HTTP method (GET, POST, etc.)
+- `HTTPJAIL_HOST` - Hostname from the URL
+- `HTTPJAIL_SCHEME` - URL scheme (http or https)
+- `HTTPJAIL_PATH` - Path component of the URL
+
+**Script requirements:**
+
+- Exit code 0 allows the request
+- Any non-zero exit code blocks the request
+- stdout is captured and included in 403 responses as additional context
+- stderr is logged for debugging but not sent to the client
+
+> [!TIP]
+> Script-based evaluation can also be used for custom logging! Your script can log requests to a database, send metrics to a monitoring service, or implement complex audit trails before returning the allow/deny decision.
+
+## Advanced Options
 
 ```bash
 # Verbose logging
@@ -277,7 +254,7 @@ HTTPJAIL_HTTP_BIND=3128 HTTPJAIL_HTTPS_BIND=3129 httpjail --server --js "true"
 HTTPJAIL_HTTP_BIND=192.168.1.100:8080 httpjail --server --js "true"
 ```
 
-### Server Mode
+## Server Mode
 
 httpjail can run as a standalone proxy server without executing any commands. This is useful when you want to proxy multiple applications through the same httpjail instance. The server binds to localhost (127.0.0.1) only for security.