Make --verbose default and add --quietHEADmain

1 files changed, 24 insertions, 21 deletions

diff --git a/README.md b/README.md
index dfe1046..af9a604 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ A Python CLI tool for bulk querying domain pricing information from the Porkbun
 - **Domain availability checking** - Shows if domains are available for registration
 - JSON Lines output format
 - SQLite caching to avoid duplicate API calls
-- **Verbose mode with progress bars** - Visual feedback for long-running queries
+- **Progress bars by default** - Visual feedback for all queries (disable with `-q`)
 - Aggressive 429 retry handling
 - Async implementation for performance
 - Multiple credential sources (CLI, env vars, config file)
@@ -55,9 +55,13 @@ porkbun test_domains.txt
 
 ### Query from File
 ```bash
-# Basic usage (reads credentials from config file)
+# Basic usage (shows progress bars by default)
 porkbun test_domains.txt
 
+# Quiet mode (disable progress bars, JSON only)
+porkbun test_domains.txt --quiet
+porkbun test_domains.txt -q
+
 # Refresh data from API and update cache
 porkbun test_domains.txt --refresh
 
@@ -66,25 +70,23 @@ porkbun test_domains.txt --clear-cache
 
 # Debug mode (shows full HTTP requests/responses and status)
 porkbun test_domains.txt --debug
-
-# Verbose mode (shows progress bars for API requests)
-porkbun test_domains.txt --verbose
 ```
 
 ### Query Single/Multiple Domains
 ```bash
-# Single domain
+# Single domain (shows progress bar by default)
 porkbun -d example.com
 porkbun --domain example.com
 
-# Multiple domains
+# Multiple domains (shows progress for each)
 porkbun -d example.com -d test.net -d sample.org
 
+# Quiet mode for clean JSON output (useful for piping)
+porkbun -d example.com -q
+echo "example.com\ntest.net" | porkbun --quiet
+
 # Combined with other flags
 porkbun -d example.com --refresh --debug
-
-# With progress bars
-porkbun -d domain1.com -d domain2.com -d domain3.com --verbose
 ```
 
 ## Debug Mode
@@ -124,9 +126,9 @@ Body: {"status":"SUCCESS","pricing":{...}}
 
 **Note:** JSON results always go to stdout, debug/status messages go to stderr for easy separation.
 
-## Verbose Mode
+## Progress Bars
 
-When `--verbose` is specified, the tool shows real-time progress bars for each domain being processed:
+**By default**, the tool shows real-time progress bars for each domain being processed. Use `-q` or `--quiet` to disable this for clean JSON-only output.
 
 **Features:**
 - Overall progress bar showing total completion
@@ -137,7 +139,7 @@ When `--verbose` is specified, the tool shows real-time progress bars for each d
   - 🔴 Red: Error occurred
 - Shows whether data came from cache or API
 
-**Example output:**
+**Example output (default):**
 ```
   Processing domains...      ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
   example.com - ✓ From cache ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
@@ -145,17 +147,18 @@ When `--verbose` is specified, the tool shows real-time progress bars for each d
   sample.org - ✓ Complete    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100%
 ```
 
-**Use with file input:**
-```bash
-porkbun domains.txt --verbose
-```
-
-**Use with multiple domains:**
+**Disable progress bars for piping:**
 ```bash
-porkbun -d domain1.com -d domain2.com -d domain3.com --verbose
+# Clean JSON output only (no progress bars)
+porkbun domains.txt -q > results.jsonl
+porkbun -d example.com --quiet | jq .
 ```
 
-**Note:** Verbose mode is especially useful when processing many domains, as it provides visual feedback on progress and shows which domains are being fetched vs cached.
+**When to use quiet mode:**
+- Piping output to other tools
+- Scripting and automation
+- When you only want the JSON output
+- Redirecting to files
 
 ## Input Format