From 9e2065aa9e16916a5fae404120b12c9b4f3693bc Mon Sep 17 00:00:00 2001
From: Cameron Pfiffer <cameron@pfiffer.org>
Date: Wed, 12 Nov 2025 10:54:04 -0800
Subject: [PATCH] Document multi-bot launcher in CLAUDE.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add documentation for run_bots.py script showing usage examples
and features.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 CLAUDE.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index d56bbe7..55307d4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -49,6 +49,24 @@ ac && python bsky.py --synthesis-only --synthesis-interval 120
 ac && python bsky.py --debug
 ```
 
+### Running Multiple Bots
+```bash
+# Run all 5 bots simultaneously with aggregated logs (docker-compose style)
+ac && python run_bots.py --synthesis-interval 0 --no-git
+
+# Run all bots in test mode
+ac && python run_bots.py --test
+
+# Run all bots with any bsky.py arguments
+ac && python run_bots.py [bsky.py arguments...]
+
+# Features:
+# - Colored output prefixes for each bot (herald, archivist, grunk, ezra, blank)
+# - Aggregated logs from all bots in real-time
+# - Graceful shutdown on Ctrl+C
+# - Arguments passed to all bots
+```
+
 ### Managing Tools
 
 ```bash
-- 
2.51.2