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

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.

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).

Quelle

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