docs: explain --no-screenshot --use-default-paths flags

Author: S1M0N38

CLAUDE.md

@@ -21,7 +21,7 @@ source .envrc
 
 ```
 usage: balatrollm [-h] [-m MODEL] [-l] [-s STRATEGY] [-u BASE_URL] [-k API_KEY] [-c CONFIG]
-                  [-d RUNS_DIR] [-r RUNS] [-p PORT]
+                  [-d RUNS_DIR] [-r RUNS] [-p PORT] [--no-screenshot] [--use-default-paths]
                   {benchmark} ...
 
 LLM-powered Balatro bot
@@ -45,6 +45,8 @@ options:
                         Base directory for storing run data (default: current directory)
   -r, --runs RUNS       Number of times to run the bot with the same configuration (default: 1)
   -p, --port PORT       Port for BalatroBot client connection (can specify multiple, default: 12346)
+  --no-screenshot       Disable taking screenshots during gameplay (use when running Balatro in headless mode)
+  --use-default-paths   Use BalatroBot's default storage paths for screenshots and game logs (use when balatrobot and balatrollm are running on different systems)
 ```
 
 ### Development

README.md

@@ -78,6 +78,11 @@ The CLI uses sensible defaults for all other configuration:
 
 # 2. Run the bot with default settings
 balatrollm
+
+# 3. Run with optimizations for different environments
+balatrollm --no-screenshot                    # Headless mode (no screenshots)
+balatrollm --use-default-paths              # Distributed systems
+balatrollm --no-screenshot --use-default-paths  # Both optimizations
 ```
 
 #### `balatrollm` - Command Line Interface
@@ -88,7 +93,7 @@ balatrollm --help
 
 ```
 usage: balatrollm [-h] [-m MODEL] [-l] [-s STRATEGY] [-u BASE_URL] [-k API_KEY] [-c CONFIG]
-                  [-d RUNS_DIR] [-r RUNS] [-p PORT]
+                  [-d RUNS_DIR] [-r RUNS] [-p PORT] [--no-screenshot] [--use-default-paths]
                   {benchmark} ...
 
 LLM-powered Balatro bot
@@ -112,6 +117,8 @@ options:
                         Base directory for storing run data (default: current directory)
   -r, --runs RUNS       Number of times to run the bot with the same configuration (default: 1)
   -p, --port PORT       Port for BalatroBot client connection (can specify multiple, default: 12346)
+  --no-screenshot       Disable taking screenshots during gameplay (use for headless mode)
+  --use-default-paths   Use BalatroBot's default storage paths (use for distributed systems)
 ```
 
 #### `Makefile` - Development Workflow

docs/usage.md

@@ -96,6 +96,21 @@ balatrollm --runs-dir ./my-experiments
 balatrollm --config ./runs/v0.10.0/default/openrouter/gpt-oss-20b/20240922_red_deck_12345/config.json
 ```
 
+### Storage and Output Options
+
+Control screenshot and file output behavior:
+
+```bash
+# Disable screenshots (ideal for headless mode)
+balatrollm --no-screenshot
+
+# Use BalatroBot's default paths (ideal for distributed systems)
+balatrollm --use-default-paths
+
+# Combine both for optimized distributed/headless setups
+balatrollm --no-screenshot --use-default-paths
+```
+
 ## Parallel Execution
 
 ### Multiple Instances
@@ -110,6 +125,21 @@ Run multiple bot instances simultaneously:
 balatrollm --port 12346 --port 12347 --port 12348 --runs 15
 ```
 
+### Distributed Systems
+
+Run balatrollm and BalatroBot on different systems:
+
+```bash
+# Docker containers and remote deployments
+balatrollm --use-default-paths
+
+# Containerized environments (no GUI, optimized storage)
+balatrollm --no-screenshot --use-default-paths
+
+# High-volume distributed testing
+balatrollm --use-default-paths --runs 100 --model x-ai/grok-code-fast-1
+```
+
 ### Performance Optimization
 
 For faster execution:
@@ -121,9 +151,12 @@ For faster execution:
 # Choose faster models
 balatrollm --model x-ai/grok-code-fast-1
 
+# Optimize for automated/headless environments
+balatrollm --no-screenshot --model x-ai/grok-code-fast-1
+
 # Combine multiple optimizations
 ./balatro.sh --headless --fast -p 12346 -p 12347
-balatrollm --model x-ai/grok-code-fast-1 --port 12346 --port 12347 --runs 20
+balatrollm --model x-ai/grok-code-fast-1 --no-screenshot --port 12346 --port 12347 --runs 20
 ```
 
 ## Configuration Files