From 8dddd0eabd464ea25f570b4c53e0666d612b3674 Mon Sep 17 00:00:00 2001
From: dschlueter <dschlueter@kitux.de>
Date: Tue, 19 May 2026 19:11:15 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20start-servers.sh=20in=20README=20erg?=
 =?UTF-8?q?=C3=A4nzt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 907f656..774318d 100644
--- a/README.md
+++ b/README.md
@@ -59,11 +59,12 @@ Nach Änderungen an `pi-coder-judge-extension.ts` oder `models.json`:
 ## Server starten / stoppen / status
 
 ```bash
-# Coder-Server starten (Port 8001)
-./start-coder.sh
+# Beide Server parallel starten (empfohlen)
+./start-servers.sh
 
-# Judge-Server starten (Port 8002)
-./start-judge.sh
+# Einzeln starten (z.B. nach Absturz eines Servers)
+./start-coder.sh   # Port 8001
+./start-judge.sh   # Port 8002
 
 # Beide stoppen
 ./stop-servers.sh
@@ -72,9 +73,13 @@ Nach Änderungen an `pi-coder-judge-extension.ts` oder `models.json`:
 ./status.sh
 ```
 
+`start-servers.sh` startet beide Container gleichzeitig und wartet bis beide
+HTTP-ready sind — schneller als sequenziell. Logs werden getrennt gesammelt
+und nur bei Fehler ausgegeben.
+
 Umgebungsvariable für alternativen Modellpfad:
 ```bash
-HF_HOME=/anderer/pfad ./start-coder.sh
+HF_HOME=/anderer/pfad ./start-servers.sh
 ```
 
 ## pi-Kommandos
@@ -97,8 +102,9 @@ HF_HOME=/anderer/pfad ./start-coder.sh
 |---|---|
 | `pi-coder-judge-extension.ts` | pi agent Extension (Kommandos, Tools, Hooks) |
 | `models.json` | Provider- und Modell-Konfiguration für pi agent |
-| `start-coder.sh` | Docker-Container für Coder-Modell (Port 8001) starten |
-| `start-judge.sh` | Docker-Container für Judge-Modell (Port 8002) starten |
+| `start-servers.sh` | Beide Server parallel starten (empfohlen) |
+| `start-coder.sh` | Nur Coder-Container starten (Port 8001) |
+| `start-judge.sh` | Nur Judge-Container starten (Port 8002) |
 | `stop-servers.sh` | Beide Container stoppen |
 | `status.sh` | Laufstatus beider Server anzeigen |
 | `install.sh` | Extension + models.json nach `~/.pi/agent/` kopieren |