Claude Colony – tmux‑basiertes Multi‑Agenten‑Orchestrierungs‑Framework

Key Takeaway

Claude Colony bietet ein tmux‑basiertes Multi‑Agenten‑Orchestrierungs‑Framework, das mehrere Claude Code‑Instanzen über eine Dateibasierte IPC und vordefinierte Team‑Konfigurationen zusammenführt, um komplexe Software‑Entwicklungsaufgaben effizient zu koordinieren.

Summary

• Ziel und Konzept
  • Orchestriert mehrere Claude Code‑Agenten innerhalb einer tmux‑Session.
  • Jeder Agent hat eine Persönlichkeit, Rolle und Fokusbereich.
  • Kommunikation erfolgt über einen dateibasierten Message‑Broker mit @mention‑Routing.
• Installation
  • Globale Installation über npm: npm install -g claude-colony
  • Alternative: npx claude-colony --help
  • Aus dem Quellcode: clone, npm install && npm run build && npm link
• Grundlegende Befehle
  • colony init – Erstellt das .colony/‑Verzeichnis.
  • colony start – Startet eine Colony‑Session (Optionen: --preset, --agents, --no-attach).
  • colony stop – Stopp der laufenden Colony.
  • colony status – Zeigt den aktuellen Status.
  • colony presets – Listet verfügbare Presets; colony presets <name> gibt Details aus.
  • colony agents – Zeigt verfügbare Agenten; colony agents <name> gibt Details aus.
  • colony create <name> – Erstellt einen neuen Agenten mit optionalen Parametern (Beschreibung, Modell, Tools, global, force).
• Preset‑Konfigurationen
  • fullstack, frontend-team, api-team, mobile-app, docs-team – jeweils spezifische Agentenzusammenstellungen für gängige Entwicklungsaufgaben.
  • Presets können durch Kombination eigener Agenten in .claude/agents/ angepasst und erweitert werden.
• Agenten‑Management
  • Agenten werden als Markdown‑Dateien im Verzeichnis .claude/agents/ definiert.
  • Standard‑Agenten liegen im Projekt‑ oder Benutzer‑Level; Built‑ins sind für Colony‑Fallback verfügbar.
  • Beispiel‑Agent api-designer enthält Name, Beschreibung, Modell und Prompt.
• Projektstruktur nach colony init
  • .colony/config.yaml – Konfiguration der Colony.
  • .colony/state/ – Sitzungszustand.
  • .colony/messages/ – Agenten‑Kommunikation.
  • .colony/agents/ – Agenten‑Prompts.
  • .colony/shared/ – Gemeinsame Datenkanäle.
  • .colony/reviews/ – Code‑Review‑Workflow.
• Architektur‑Komponenten
  • MessageBroker, SessionManager, TmuxManager, CompletionDetector, ColonyMonitor, SharedScratchpad, OwnershipRegistry, ReviewManager, DependencyGraph, FileLock.
  • Agenten senden Nachrichten im Format @role: Nachricht.
• Tmux‑Interaktion
  • tmux attach -t colony zum Anlegen oder Anhängen.
  • Steuerung: Ctrl+B + Pfeiltasten zum Schalten; Ctrl+B + D zum Detach.
• Entwicklungs‑Pipeline
  • Befehle: npm install, npm run build, npm test, npm run test:run, npm run typecheck, npm run lint, npm run check.
• Anforderungen
  • Node.js 18+ (LTS empfohlen).
  • tmux.
  • Claude Code CLI (claude).
• Lizenz – MIT‑Lizenz.
• Beitragende – Zwei Hauptmitarbeiter: Jamie Murphy (GitHub) und Claude (GitHub).

Related queries:

```markdown
Wie installiert man Claude Colony?
```
```markdown
Welche Presets unterstützt Claude Colony?
```
```markdown
Wie erstelle ich einen Agenten im Projekt ohne Markdown?
```

Quelle: https://github.com/MakingJamie/claude-colony