TheBotCompany Einstieg: Ein neues Paradigma für KI-Teams mit null manueller Intervention

In 30 Minuten startklar | Selbstständige Zusammenarbeit mit drei Rollen | Multi-Provider-Fallbacks | Automatisierung der gesamten Kette von der Anforderung bis zum PR

---

Projektüberblick

TheBotCompany ist eine Plattform für KI-Entwicklungsteams, bei der du „wirklich loslassen“ kannst. Die Kernidee ist ganz direkt: Statt dass du allein mit KI chatten und Code schreiben musst, stellst du ein Team aus mehreren KI-Agenten zusammen – eine Person plant, eine Person schreibt Code und eine Person prüft und verifiziert. Sie diskutieren, verteilen Aufgaben und verwalten den Fortschritt selbstständig; du musst nur dann eingreifen, wenn sie auf wirklich Fragen treffen, die menschliche Urteilsfähigkeit erfordern.

Im Team gibt es drei feste Management-Rollen: Athena übernimmt die strategische Planung und definiert Meilensteine sowie den Budgetrahmen pro Zyklus; Ares führt die Umsetzung an und zerlegt Meilensteine in konkrete Aufgaben für die Worker-Agenten; Apollo ist für die Abnahme zuständig und prüft Ares’ Ergebnisse mit hohen Qualitätsstandards – bei Nichtbestehen wird es zurückgewiesen. Du musst nicht die ganze Schleife im Blick behalten: Das Dashboard zeigt dir live, was jeder Agent macht, wie viel er kostet und welche Probleme aufgetreten sind.

---

Zielgruppe

Dieser Artikel richtet sich an folgende Entwickler:

• Du hast bereits Entwicklungserfahrung und möchtest repetitive Codierungsarbeit an ein KI-Agent-Team abgeben, damit du dich auf Entscheidungen und Architektur konzentrieren kannst
• Du interessierst dich für Konzepte wie Multi-Agent-Zusammenarbeit und selbstorganisierte Teams und suchst nach Praxisbeispielen
• Du nutzt bereits einen Single-Agent zur Unterstützung, möchtest aber auf mehrere Agenten erweitern und mehrere Richtungen parallel bearbeiten

Wenn du das willst, was sich wie ein „Tool zum Einrichten und dann komplett durchgängig ablegen“ anfühlt, musst du die Erwartungen zuerst senken – TheBotCompany reduziert menschliche Eingriffe stark, aber es ist nicht komplett ohne dich möglich.

---

Wichtige Abhängigkeiten und Umgebung

---

Vollständige Projektstruktur (Tree)

Nach der Installation und dem Start wird unter ~/.thebotcompany/ folgende Struktur erzeugt:

~/.thebotcompany/
├── keys.json              # Verschlüsselt gespeicherte API Keys
├── db.sqlite              # Issue-Tracker-Datenbank
├── config.yaml            # Globale Konfiguration
└── logs/                  # Laufprotokolle (Logs)

Dein Projektordner/
├── workers/               # Skill-Definitionen für Worker-Agenten
│   ├── leo.md             # Frontmatter: reports_to, role, model
│   └── maya.md
├── workspace/             # Arbeitsbereiche der einzelnen Agenten
│   ├── athena/note.md
│   ├── ares/note.md
│   └── leo/note.md
└── .tbc/                  # Projektweite Konfiguration (bei Projekt-Erstellung erzeugt)

---

Schritt-für-Schritt Installationsanleitung

Schritt 1: TheBotCompany installieren

npm install -g thebotcompany

Installation verifizieren:

tbc --version

Schritt 2: Dienst starten

tbc start

Beim ersten Start wirst du Schritt für Schritt dazu aufgefordert, diese Einstellungen vorzunehmen:

1. Dashboard-Zugriffs-Passwort — zum Schutz von Schreibaktionen (Pause, Resume, Konfiguration ändern)
2. Port — Standard ist 3100; einfach Enter drücken, um den Default zu übernehmen

? Set a password for dashboard write access: ********
? Port to run the dashboard (default 3100):

Nach erfolgreichem Start ist das Dashboard unter http://localhost:3100 erreichbar. Standardmäßig läuft es nur im Lesemodus; erst nach dem Login kannst du Aktionen ausführen.

Schritt 3: API Key konfigurieren

Öffne das Dashboard (http://localhost:3100), klicke oben rechts auf Settings und füge im Keys-Panel deinen API Key hinzu. Du kannst ihn beim Erststart auch automatisch über Umgebungsvariablen erkennen lassen:

# Füge in .bashrc oder .zshrc hinzu:
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...

Schritt 4: Projekt über das Dashboard erstellen

1. Öffne http://localhost:3100
2. Klicke auf New Project und fülle aus:
   • Repository URL — deine GitHub-Repo-Adresse (benötigt, dass gh die nötigen Berechtigungen hat)
   • Provider — wähle den LLM-Provider aus
   • Model Tier — welche Modelle pro Ebene genutzt werden (high/mid/low)
3. Klicke auf Create – und übergib die Kontrolle an Athena, damit sie startet

---

Detaillierte Erklärung der Architektur mit drei Rollen

Das ist das Herzstück des Designs von TheBotCompany. Wenn du es verstehst, weißt du, wie das gesamte System funktioniert.

Drei feste Management-Rollen

Die komplette Cycle-Schleife

PLANNING-PHASE (Athena)
  → Athena + ihre Worker-Agenten laufen
  → Recherche, Bewertung, Brainstorming
  → Meilensteine definieren → geht in IMPLEMENTATION über

IMPLEMENTATION-PHASE (Ares)
  → Ares + seine Worker-Agenten laufen (max. N Cycle)
  → Ares erklärt „fertig“ → geht in VERIFICATION über
  → Budget für Zyklen überschritten → zurück zu PLANNING und erneut bewerten

VERIFICATION-PHASE (Apollo)
  → Apollo + seine Worker-Agenten laufen
  → Apollo nimmt ab → geht in das nächste PLANNING
  → Apollo weist zurück → zurück zu IMPLEMENTATION zur Reparatur

Wie Worker-Agenten arbeiten

Manager (Ares / Athena / Apollo) „rekrutieren“ Worker-Agenten, indem sie im Verzeichnis {project_dir}/workers/ eine .md-Datei erstellen. Jede Datei hat ein festes YAML-Frontmatter:

---
reports_to: ares          # An wen wird berichtet
role: Frontend Engineer   # Aufgabenbeschreibung
model: mid                # Welche Modellvariante
---

# Frontend Engineer

Du bist ein Frontend-Ingenieur und verantwortlich für die Umsetzung von UI-Komponenten und Interaktionslogik.

Wenn ein Manager Aufgaben an Worker verteilt, wird immer nur eine Aufgabe pro Zyklus vergeben – es ist nicht erlaubt, fünf Aufgaben auf einmal in einen Zyklus zu packen. Wenn der Worker fertig ist, liest der Manager das note.md im Workspace, um den Kontext zu verstehen, und entscheidet dann über den nächsten Schritt.

Kommunikationsmethode zwischen Agenten

Agenten chatten nicht direkt miteinander, sondern koordinieren sich über einen integrierten Issue Tracker:

• Ares benötigt Athenas Meinung → erstellt im Issue Tracker ein Issue und weist es Athena zu
• Worker stößt auf ein Problem → erstellt ein Issue, der Manager sieht es und bearbeitet es
• Manuelle Einmischung nötig → erstellt ein GitHub Issue, dessen Titel mit HUMAN: beginnt; du loggst dich bei GitHub ein und bearbeitest es

---

Vollständige Demo des Entwicklungsprozesses

Step 1: Projekt über das Dashboard erstellen

Öffne das Dashboard und klicke auf New Project:

Repository: https://github.com/your-username/your-repo
Provider: Anthropic
Model: claude-sonnet-4

Nach der Erstellung erscheint im Dashboard eine Projekt-Karte. Der Status ist PLANNING und Athena beginnt mit der Arbeit.

Step 2: Athenas Planungsprozess beobachten

Im Panel Agent Reports des Dashboards siehst du Athenas Ausgaben. Sie macht dabei u. a. Folgendes:

• liest das Projekt-README und den existierenden Code, um den Ist-Zustand zu verstehen
• sucht nach passenden technischen Ansätzen und Best Practices
• bewertet die Umsetzbarkeit der Anforderungen
• definiert den ersten Meilenstein und sein Budget (wie viele Cycle)

Sobald die Meilenstein-Definition abgeschlossen ist, schaltet das System automatisch in die Phase IMPLEMENTATION und Ares geht online.

Step 3: Ares setzt die Umsetzung um

Der Dashboard-Status wechselt auf IMPLEMENTATION und Ares startet:

1. Worker rekrutieren — Ares erstellt Dateien wie workers/leo.md, workers/maya.md usw.
2. Aufgaben zuweisen — in jedem Cycle wird genau ein Worker mit einer konkreten Aufgabe betraut
3. PR prüfen — nachdem Worker eine PR eingereicht haben, führt Ares ein Code Review durch
4. Cycle-Steuerung — falls etwas in einem Cycle nicht geschafft wird, wird es zurückgewiesen und im nächsten Cycle erneut versucht

Du kannst Ares direkt über das Panel Chat im Dashboard eine Nachricht schicken, um die Richtung anzupassen oder Kontext zu ergänzen.

Step 4: Apollo nimmt ab

Wenn Ares verkündet, dass der Meilenstein abgeschlossen ist, schaltet das System auf VERIFICATION und Apollo startet:

→ Apollo liest die Code-Änderungen
→ führt Validierungstests aus (über GitHub Actions)
→ prüft, ob die Meilensteinanforderungen erfüllt sind
→ bestanden → in das nächste PLANNING
→ nicht bestanden → zurück zu IMPLEMENTATION, mit Hinweis auf die konkreten Probleme

Apolos Standards liegen eine Stufe höher als die von Ares – daher kommt es häufig vor, dass „Ares denkt, es passt, aber Apollo weist zurück“. Das ist beabsichtigt und kein Bug.

Step 5: Manuelle Intervention (falls nötig)

Wenn ein Agent auf etwas trifft, das wirklich menschliches Urteilsvermögen erfordert, erstellt er ein GitHub Issue mit dem Prefix HUMAN::

HUMAN: Login-Seite mit OAuth oder mit Benutzername/Passwort?
Bitte antworte auf dieses Issue in GitHub. Agent fährt dann basierend auf deiner Antwort fort.

Nach deiner Antwort macht Ares weiter. Wenn du keine Intervention brauchst, kannst du das Projekt einfach im Dashboard pausieren.

---

Dashboard: Funktionsübersicht im Detail

Das Dashboard von TheBotCompany ist das zentrale Kontrollzentrum des gesamten Systems – hier siehst du alle Status auf einen Blick.

Projektübersicht

Die Dashboard-Startseite zeigt alle Projekt-Karten. Jede Karte zeigt:

• die aktuelle Phase (PLANNING / IMPLEMENTATION / VERIFICATION)
• den aktuellen Cycle / Epoch-Zähler
• den Fortschritt der Meilensteine (Fortschrittsbalken)
• eine Zusammenfassung des letzten Agent Reports

Agent Reports

Die Agent-Ausgabe-Historie jedes Projekts wird angezeigt. Markdown wird gerendert und es gibt eine automatische Zusammenfassung. Wenn die Ausgabe eines Cycles besonders lang ist, komprimiert das Dashboard sie automatisch und zeigt nur die wichtigsten Schlussfolgerungen.

Issue Tracker

Die gesamte Koordination zwischen Agenten läuft hier:

• nach Projekt filtern
• nach Status filtern (Open / In Progress / Resolved)
• nach Agent filtern
• spezielles Panel Human Issues mit allen Upgrade-Anfragen, die du bearbeiten musst

Chat

Im Dashboard gibt es einen eingebauten direkten Chat-Einstieg: Du kannst ein beliebiges Projekt auswählen und dem jeweiligen Manager eine Nachricht senden, um Kontext zu ergänzen oder die Richtung anzupassen. Unterstützt Streaming-Antworten und das Hochladen von Bildern.

Kosten-Tracking

Kostenaufstellung pro Projekt und pro Agent:

• Kosten des letzten Cycles
• durchschnittliche Kosten der letzten 24 Stunden
• kumulierte Gesamtkosten

In Kombination mit Budget Controls kannst du einen 24h rolling Budget-Limit setzen. Wenn es überschritten wird, versetzt das System die Agenten automatisch in den Ruhezustand.

Controls

Schnellaktionen im Dashboard:

• Pause / Resume — Projekt pausieren und wieder fortsetzen (Login erforderlich)
• Skip Sleep — die vordefinierte Ruhepause überspringen und sofort in den nächsten Cycle starten
• Kill Run / Cycle / Epoch — den aktuellen Lauf/den Cycle/die Epoch zwangsweise beenden
• Bootstrap — ab einem definierten Meilenstein neu starten

---

Multi-Provider- und Key-Pool-Verwaltung

Unterstützte Provider-Liste

TheBotCompany unterstützt integrierte 15+ LLM Provider:

So funktioniert der Key Pool

Im Settings-Panel Keys kannst du für denselben Provider mehrere Keys hinzufügen und eine Prioritätsreihenfolge festlegen. Zur Laufzeit:

1. Das System nutzt zuerst den Key mit der höchsten Priorität
2. Wenn dieser Key ein Rate-Limit (429) auslöst oder das Kontingent nicht ausreicht → automatische Umschaltung auf den nächsten Key
3. Nach Ablauf der Abkühlzeit ist der Key wieder nutzbar und kommt erneut in die Rotation

Das ist besonders nützlich für Projekte, die lange laufen – du musst dir keine Sorgen machen, dass ein einzelner Key das Team lahmlegt.

Model-Tier-Konfiguration

Für jedes Projekt kannst du definieren, welche Modelle pro Ebene verwendet werden:

# Projektweite .tbc/config.yaml
model_tiers:
  high: claude-opus-4       # komplexe Architektur, tiefes Reasoning
  mid: claude-sonnet-4      # Default, Balance aus Fähigkeit und Kosten
  low: claude-haiku-3       # einfache repetitive Aufgaben, Formatierung

Du kannst die Einstellungen auch direkt im Panel Model Tier Overrides in Settings per UI ändern – ohne das Config-File anzufassen.

---

Häufige Probleme beheben

Q1: Nach tbc start lässt sich das Dashboard nicht öffnen – es erscheint „Connection Refused“

Ursache: Der Port ist belegt oder der Dienst startet nicht korrekt.

Schritte zur Diagnose:

# 1. Prüfen, ob tbc läuft
tbc status

# 2. Wenn nicht: manuell starten und die Fehlermeldung ansehen
tbc dev

# 3. Wenn der Port belegt ist: einen anderen Port verwenden
TBC_PORT=3200 tbc start

---

Q2: Das Agent-Team bleibt immer in PLANNING und wechselt nie zu IMPLEMENTATION

Ursache: Athena macht eine gründliche Recherche oder wartet auf Ergebnisse der Worker-Agenten und hat noch keine Meilensteine definiert.

Lösung:

Öffne Dashboard → Agent Reports und prüfe die neuesten Ausgaben von Athena. Wenn sie auf ein Recherche-Ergebnis eines Worker-Agenten wartet, kannst du mit /tbc logs die Server-Logs ansehen, um zu bestätigen, ob sie wirklich festhängt. Wenn sie tatsächlich feststeckt, schicke direkt im Panel Chat an Athena die Nachricht: „Bitte definiere basierend auf den vorhandenen Informationen den ersten Meilenstein – kein weiteres Warten auf Recherche erforderlich.“

---

Q3: GitHub PR wird nicht automatisch erstellt, und Agent meldet im Issue Tracker einen Berechtigungsfehler

Ursache: Die gh CLI ist nicht korrekt authentifiziert oder die Token-Berechtigungen reichen nicht.

Schritte zur Diagnose:

# 1. Prüfen, ob gh eingeloggt ist
gh auth status

# 2. Falls nicht: erneut authentifizieren (benötigt Repo-Rechte)
gh auth login --scopes repo

# 3. Prüfen, ob die Remote-URL im Projektverzeichnis korrekt ist
cd /path/to/your-project
git remote -v

---

Q4: Apollo weist Ares’ Umsetzung immer zurück und verursacht damit eine Cycle-Endlosschleife

Ursache: Die Richtung, in der Ares jedes Mal repariert, passt nicht zu dem, was Apollo erwartet – oder die Meilenstein-Definition ist selbst nicht klar genug.

Lösung:

Sende im Panel Chat im Dashboard an Ares: „Apolos Zurückweisungsgrund ist [füge den konkreten Kommentar aus dem Apollo Report ein]. Bitte kläre vor der Reparatur, wie Apollo die Standards versteht, und bestätige mit Apollo die Reparaturrichtung, bevor du loslegst.“

Wenn die Standards von Apollo zu streng sind, kann Athena in der PLANNING-Phase die Abnahmekriterien des Meilensteins anpassen.

---

Q5: Die Kosten liegen deutlich über der Erwartung – du willst sofort alle Agenten pausieren

Lösung:

# Methode 1: Dashboard bedienen
# Login ins Dashboard → bei jedem Projekt die Karte → Controls → Pause

# Methode 2: CLI pausieren
tbc stop

# Methode 3: Budget-Obergrenze setzen (wirkt beim nächsten Start)
# Dashboard Settings → Budget Controls → 24h Budget-Limit setzen

---

Q6: Mehrere API Keys hinzugefügt, aber Agent nutzt immer denselben Key und läuft in ein Limit

Ursache: Die Prioritätsreihenfolge im Key Pool ist möglicherweise falsch, oder die Abkühlzeit wegen Rate-Limits ist noch nicht vorbei.

Lösung:

Prüfe im Dashboard unter Settings → Keys den Status der einzelnen Keys:

• Active — wird normal verwendet
• Cooldown — Rate-Limit ausgelöst, Abkühlung läuft
• Exhausted — Kontingent aufgebraucht

Wenn ein Key lange im Cooldown-Modus ist, verschiebe ihn manuell ans Ende der Key-Liste, damit das System auf den nächsten Key umschaltet.

---

Weiterführende Lektüre und fortgeschrittene Richtungen

1. Fähigkeiten (Skills) für Worker-Agenten anpassen

Erstelle im workers/-Verzeichnis neue .md-Dateien, um die Teamfähigkeiten zu erweitern:

---
reports_to: ares
role: DevOps Engineer
model: mid
---

# DevOps Engineer

Du bist ein DevOps-Ingenieur und beherrschst CI/CD-Pipelines, Containerisierung und Infrastructure as Code.

Der Manager erkennt neue Worker-Agenten automatisch; sobald der nächste Cycle beginnt, können sie eingeplant werden.

2. Custom Provider anbinden

Wenn du einen LLM-Dienst aus deinem Unternehmen anbinden musst (OpenAI- oder Anthropic-kompatibles Format), gehe zu Settings → Keys → Add Custom Provider:

{
  "name": "my-internal-llm",
  "baseUrl": "https://llm.internal.company.com/v1",
  "apiKey": "sk-internal-...",
  "model": "gpt-4"
}

3. Intensive Integration mit GitHub Actions

Das Agent-Design von TheBotCompany ermutigt dazu, zeitaufwendige Tests und Builds in GitHub Actions auszuführen. Lege im Skill-File des Worker-Agenten fest:

Führe niemals Tests direkt im Terminal aus, die länger als 5 Minuten dauern. Alle Test-Suites werden über GitHub Actions ausgelöst.

So gehen Code und CI-Ergebnisse nicht verloren, wenn ein Agent wegen Timeout im Cycle gekillt wird.

4. Multi-Projekt-Management und Gesamtüberblick

Wenn du gleichzeitig mehrere Projekte laufen hast (Open-Source-Wartung, Side Project, kommerzielles Projekt), macht das einheitliche Dashboard von TheBotCompany alles auf einen Blick sichtbar: Status, Ausgaben und die Verteilung von Problemen. Mit den Projekt-Filteroptionen oben kannst du schnell wechseln, und die Human-Issues-Seite bündelt alle Upgrade-Anfragen an einem Ort – ohne dass Entscheidungen übersehen werden.

5. Feinere Budget- und Kostenkontrolle

Das standardmäßige 24-Stunden rolling Budget-Limit gilt global. Wenn du unterschiedliche Budgets für unterschiedliche Projekte setzen willst, kannst du mehrere TheBotCompany-Instanzen starten (jeweils ein anderes TBC_HOME-Verzeichnis). Jede Instanz verwaltet unabhängig eine eigene Gruppe von Projekten und Budgets – ohne gegenseitige Beeinflussung.