Install
curl -fsSL https://get.cotal.ai | shCotal ist ein Open-Source-Publish/Subscribe-Standard (pub/sub) für KI-Agenten, der es Agenten und Diensten auf verschiedenen Anwendungen und Maschinen ermöglicht, sich einen gemeinsamen Kollaborationsraum zu teilen. Die TypeScript-Implementierung läuft auf NATS + JetStream und umfasst eine CLI, Konnektoren, einen Prozessmanager, persistente Workflows und Observability-Tools.
Für wen ist es geeignet?
- Für Entwickler oder Teams, die mehrere KI-Agenten lokal über Anwendungen und Maschinen hinweg zusammenarbeiten lassen möchten – insbesondere in Szenarien, in denen Agenten-Fähigkeiten über einheitliche Dienstverträge (Beschreibung und Aufruf) kombiniert werden sollen.
- Geeignet für Nutzer, die bereit sind, lokal eine Reihe von Hintergrundprozessen zu betreiben (Mesh, Zustell-Daemon, Manager).
- Nicht geeignet, wenn: Sie nur reine Einmalskripte benötigen, keine dauerhaft laufenden lokalen Hintergrundprozesse akzeptieren können oder Ihre Umgebung nicht über Node 22.10+ verfügt (und der offizielle curl-Installer nicht praktikabel ist) – in diesem Fall sollten Sie zuerst die Machbarkeit prüfen. Für Windows-Nutzer ist der offiziell empfohlene Weg die Installation über npm.
Erster Versuch in 3 Minuten
Der empfohlene Hauptweg ist der offizielle curl-Installer (schreibt in das Benutzer-Home-Verzeichnis, kein sudo nötig, und öffnet ein geführtes Setup):
curl -fsSL https://get.cotal.ai | sh
Starten Sie nach der Installation die lokale Umgebung:
cotal up
cotal up startet im Hintergrund das lokale Mesh, den Zustell-Daemon und den Manager. Anschließend können Sie:
cotal spawn: einen Agenten im Terminal öffnen.cotal console: den Zustand des Teams (der Agenten) einsehen.
Eine risikoarme erste Beobachtungsaktion ist der Aufruf von cotal console, um den Zustand des lokalen Teams zu prüfen; dabei entstehen keine Schreiboperationen auf entfernte Systeme. Um den lokalen Stack zu stoppen, lautet der offizielle Befehl cotal down.
Zweiter Weg (offiziell angegeben, aber nicht gleichrangiger Haupteinstieg): Wenn Sie bereits Node 22.10+ haben oder unter Windows arbeiten, können Sie npm install -g cotal-ai verwenden und anschließend cotal setup ausführen. Das Setup bereitet einen Space vor, konfiguriert die ausgewählten Anwendungen und legt einen default-Persona an. Wenn Sie nur die Vorbereitung ohne Anwendung der Konfiguration möchten, steht cotal setup --configure-only zur Verfügung.
Hinweis: Das geführte Setup schreibt lokale Konfiguration (Space, Anwendungskonfiguration, Persona) – das ist ein Schreibvorgang im lokalen Zustand, keine rein lesende Aktion.
Anwendungsfälle
Fall 1: Den Zustand des lokalen Teams einsehen. Szenario: Sie haben Cotal gerade installiert und möchten bestätigen, dass das lokale Mesh läuft. Vorgehen: Starten Sie zuerst mit cotal up die Hintergrundprozesse und führen Sie dann cotal console aus. Erwartbares Ergebnis: Sie sehen die Darstellung der Teammitglieder im aktuellen Space; dies ist ein Beobachtungsschritt, der sich im Rahmen der belegbaren Informationen direkt bestätigen lässt.
Fall 2: Einen Agenten um Mithilfe von Teamkollegen bitten. Szenario: Sie haben mit cotal spawn einen Agenten im Terminal geöffnet und möchten, dass er neue Teamkollegen hinzuzieht. Vorgehen: Zu den Tools, die Cotal den Agenten bereitstellt, gehören cotal_spawn (Teamkollegen anfordern) sowie cotal_describe und cotal_invoke (Befehlsverträge zum Auffinden und Aufrufen von Diensten im Rahmen ihrer Konnektoren und Berechtigungen). Erwartbares Ergebnis: Der Agent löst über diese Tools Anfragen nach Teamkollegen aus oder ruft Dienstverträge auf; die konkreten Ausgabedetails sind in der offiziellen Dokumentation nicht einzeln aufgeführt – belegbar ist das Vorhandensein dieser Tools und wie sie ausgelöst werden.
Nutzungsgrenzen
- Lese-/Schreibverhalten:
cotal up/downverwaltet lokale Hintergrundprozesse,cotal setupschreibt lokale Konfiguration (Space, Anwendungskonfiguration, Persona);cotal consoleist eine beobachtende Operation. Verwechseln Sie lokale Schreibvorgänge nicht mit „nur lesend“. - Nebeneffekte und Bestätigungspunkte: Die CLI sendet standardmäßig Nutzungs-Telemetriedaten; dies ist ein offiziell genannter Nebeneffekt, der sich vor dem Start mit
cotal telemetry offdeaktivieren lässt. - Anmeldedaten und Berechtigungen: Die Aufrufmöglichkeiten eines Agenten sind durch seine Konnektoren und Berechtigungen (Grants) begrenzt; der offizielle Standardumfang der Grants ist nicht dokumentiert und muss vor der Nutzung in Ihrer eigenen Umgebung geprüft werden.
- Noch nicht bestätigte Informationen: Der konkrete Inhalt der Telemetriedaten, der Netzwerk-Expositionsumfang des Mesh sowie die konkreten Rückgabeformate von
cotal_describe/cotal_invokewerden auf den offiziellen Seiten nicht erläutert – eine Beurteilung von Datenschutz- und Netzwerkgrenzen kann daher nicht für Sie übernommen werden. - All dies stellt keine eigenständige Sicherheitsbewertung dar; ob es für Ihre Umgebung passt, beurteilen Sie bitte selbst anhand der genannten bekannten und unbekannten Punkte.