yarikleto/claude-agent-teams

Was macht claude-agent-teams?

CLI zur Installation von Claude Code Agent Teams – gebündelte Agenten, Fähigkeiten, Slash-Befehle, Hooks, Skripte und MCP-Server – in den Projekt- oder Benutzerbereich, mit präzisem Hinzufügen/Entfernen.

Beschreibung

claude-agent-teams ist ein Befehlszeilenwerkzeug, das das Installieren und Entfernen kompletter Agent Teams in Claude Code vereinfacht. Ein Team ist ein Paket aus:

• Agenten
• Skills
• Slash-Befehle
• Hooks
• Skripte
• MCP-Server

Diese können entweder im Projektbereich (.claude/ im aktuellen Verzeichnis) oder im Benutzerbereich (standardmäßig ~/.claude/) installiert werden.

Verwendung

# Ein Team im aktuellen Projekt installieren
claude-agent-teams install team-name

# Ein Team global für den Benutzer installieren
claude-agent-teams install --global team-name

# Ein Team aus dem aktuellen Projekt entfernen
claude-agent-teams remove team-name

# Ein Team global entfernen
claude-agent-teams remove --global team-name

Argumente & Optionen

Argument/Option	Beschreibung
install	Installiert ein Agent Team.
remove	Entfernt ein bereits installiertes Agent Team.
--global	Führt die Operation im Benutzerbereich aus (anstatt lokal).
team-name	Der Name des Teams (wie in der Registry definiert).

Beispiele

Ein Team lokal installieren:

claude-agent-teams install my-team

Dieser Befehl legt die Konfigurationsdateien von my-team im .claude/-Verzeichnis des aktuellen Projekts an.

Ein Team global installieren:

claude-agent-teams install --global core-automation

Dieses Team steht dann allen Projekten auf dem Rechner des Benutzers zur Verfügung.

Ein Team lokal entfernen:

claude-agent-teams remove my-team

Löscht die Konfigurationsdateien von my-team aus dem .claude/-Ordner des Projekts.

Wie es funktioniert

Das Tool durchsucht eine vordefinierte Team-Registry (entweder lokal oder online) nach dem angegebenen Teamnamen. Findet es das Team, kopiert es die enthaltenen Dateien (Agent-Definitionen, Skill-Manifeste, Slash-Befehlsvorlagen, Hook-Skripte, MCP-Server-Konfigurationen etc.) an den entsprechenden Zielort (.claude/ für lokal, ~/.claude/ mit --global). Bei der Entfernung löscht es diese Dateien wieder, wobei alle Änderungen auf das spezifische Team beschränkt bleiben.

Voraussetzungen

• Claude Code CLI muss installiert und konfiguriert sein.
• Schreibzugriff auf das Projektverzeichnis (bei lokaler Installation) oder auf ~/.claude/ (bei globaler Installation).

Erweiterte Nutzung

Benutzerdefinierte Registry

Sie können eine eigene Registry mit Teams definieren, indem Sie eine Konfigurationsdatei anlegen:

{
  "registries": [
    {
      "url": "https://example.com/my-teams.json",
      "name": "my-registry"
    }
  ]
}

Team-Manifest

Jedes Team benötigt ein Manifest (z.B. team.json), das die enthaltenen Komponenten beschreibt:

{
  "name": "my-team",
  "description": "Ein Beispielteam für Code-Review-Aufgaben",
  "agents": ["reviewer"],
  "skills": ["code-review"],
  "slashCommands": ["/review"],
  "hooks": ["post-commit"],
  "scripts": ["setup.sh"],
  "mcpServers": ["filesystem"]
}

Fehlerbehebung

• Team nicht gefunden: Überprüfen Sie die Registry-Quelle und den Teamnamen.
• Berechtigungsfehler: Stellen Sie sicher, dass Sie Schreibrechte auf das Zielverzeichnis haben.
• Konflikte mit bestehenden Dateien: Das Tool überschreibt nur Dateien, die explizit zum Team gehören. Gleichnamige Dateien aus anderen Quellen werden nicht automatisch geändert.

Lizenz

MIT