pulsingjupiter/gaia

Was macht gaia?

Gaia – KI-Arbeitskräfteplattform zur Orchestrierung von Claude Code-Sitzungen über benannte Agenten-Personas hinweg.

Übersicht

Gaia ermöglicht es Ihnen, mehrere spezialisierte KI-Agenten zu definieren und zu betreiben, die jeweils eine bestimmte Rolle in Ihrem Entwicklungsworkflow übernehmen. Jeder Agent erhält einen eindeutigen Namen, eine Rollenbeschreibung und kann auf bestimmte Tools oder Kontexte zugreifen. Die Plattform orchestriert die Kommunikation zwischen diesen Agenten und verwaltet parallele Sitzungen, sodass sie wie ein echtes Team von Entwicklern zusammenarbeiten können.

Funktionen

• Benannte Agenten-Personas: Definieren Sie Agenten mit spezifischen Rollen (z. B. "Code-Reviewer", "Architekt", "Tester").
• Sitzungsorchestrierung: Starten, stoppen und verwalten Sie mehrere Claude Code-Sitzungen gleichzeitig.
• Kontextfreigabe: Geben Sie Kontextinformationen (Dateien, Verzeichnisse, vorherige Entscheidungen) zwischen Agenten frei.
• Persistente Konfiguration: Speichern Sie Agentenprofile und -konfigurationen für die Wiederverwendung.
• Integration mit Claude Code: Nahtlose Anbindung an die Claude Code CLI.

Erste Schritte

1. Claude Code installieren: Stellen Sie sicher, dass claude CLI auf Ihrem System verfügbar ist.
2. Gaia installieren: Führen Sie npm install -g @pulsingjupiter/gaia aus.
3. Agenten konfigurieren: Erstellen Sie eine gaia.config.json Datei mit Ihren Agenten-Personas:

{
  "agents": [
    {
      "name": "Code-Reviewer",
      "role": "Überprüft Codeänderungen auf Qualität, Sicherheit und Best Practices",
      "claudeConfig": {
        "maxTokens": 2000
      }
    },
    {
      "name": "Architekt",
      "role": "Entwirft Systemarchitektur und bewertet Designentscheidungen",
      "claudeConfig": {
        "maxTokens": 3000
      }
    }
  ]
}

4. Sitzung starten: gaia run --agent "Code-Reviewer" --task "PR #42 reviewen"

Verwendung

CLI-Befehle

Befehl	Beschreibung
gaia run	Startet eine neue Sitzung für einen bestimmten Agenten
gaia list	Listet alle konfigurierten Agenten auf
gaia status	Zeigt den Status aktiver Sitzungen an
gaia stop	Stoppt eine aktive Sitzung

Umgebungsvariablen

• GAIA_CONFIG_PATH – Pfad zur Konfigurationsdatei (Standard: ./gaia.config.json)
• CLAUDE_API_KEY – API-Schlüssel für Claude (wenn nicht über claude CLI verfügbar)

Beispiele

Parallel-Review-Sitzung ausführen:

gaia run --agent "Architekt" --task "Architektur von feature-x analysieren"
gaia run --agent "Code-Reviewer" --task "Implementierung von feature-x reviewen"

Konfiguration mit Kontextfreigabe:

{
  "sharedContext": ["./docs", "./src/architektur.md"],
  "agents": [...]
}

Lizenz

MIT