@btcemail/cli 0.3.0 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 Command-line interface for btc.email - spam-free email powered by Bitcoin Lightning.
 
-Current version: 0.3.0 (December 28, 2025)
+Current version: 0.4.0 (December 28, 2025)
 
 ## Installation
 
@@ -105,6 +105,82 @@ btcemail credits purchase         # Shows options
 btcemail credits purchase --option 1 --wait
 ```
 
+### Settings
+
+```bash
+# Show current settings
+btcemail settings                 # or: btcemail settings show
+
+# Set email price in sats
+btcemail settings pricing 100
+
+# Toggle payment requirement
+btcemail settings require-payment on
+btcemail settings require-payment off
+
+# Toggle auto-whitelist after payment
+btcemail settings auto-whitelist on
+btcemail settings auto-whitelist off
+
+# Set custom auto-reply message
+btcemail settings auto-reply "Thanks for your email!"
+btcemail settings auto-reply --clear   # Reset to default
+```
+
+### Whitelist
+
+Manage senders who can email you for free.
+
+```bash
+# List whitelist entries
+btcemail whitelist                # or: btcemail wl
+
+# Add email or domain
+btcemail whitelist add friend@example.com
+btcemail whitelist add @company.com --note "Work contacts"
+
+# Remove entry by ID
+btcemail whitelist remove <entry-id>
+```
+
+### Blocklist
+
+Manage blocked senders (silently rejected).
+
+```bash
+# List blocklist entries
+btcemail blocklist                # or: btcemail bl
+
+# Add email or domain
+btcemail blocklist add spammer@example.com
+btcemail blocklist add @spam.com --reason "Known spam domain"
+
+# Remove entry by ID
+btcemail blocklist remove <entry-id>
+```
+
+### Network
+
+Switch between testnet and mainnet Lightning networks.
+
+```bash
+# Show current network mode
+btcemail network
+
+# Switch to testnet (fake Bitcoin)
+btcemail network testnet
+
+# Switch to mainnet (real Bitcoin)
+btcemail network mainnet
+```
+
+### Stats
+
+```bash
+# Show dashboard statistics
+btcemail stats
+```
+
 ## Options Reference
 
 ### list