Voraussetzungen

Diese drei Dinge brauchst du

Bevor du startest, prüfe diese drei Punkte. Alle drei müssen erfüllt sein.

macOS 12 Monterey oder neuer

Prüfen: Apple-Menü (oben links) → Über diesen Mac → Versionsnummer ablesen. macOS 12, 13, 14, 15 sind alle unterstützt.

Node.js Version 18 oder neuer

Node.js ist die Laufzeitumgebung für den lokalen Server. Prüfen mit node --version. Zeigt v18.x.x oder höher → weiter. Sonst nodejs.org → LTS-Version herunterladen.

Claude Code CLI + Claude-Konto

Claude Code ist das KI-Werkzeug deiner Agenten. Prüfen mit claude --version. Wenn nicht vorhanden: npm install -g @anthropic-ai/claude-code. Danach einmalig claude login. Voraussetzung: aktives Claude Pro oder Claude Max Abo.

Installation

Vier Schritte zum laufenden Dashboard

1

Software herunterladen

Lade die Datei agent-manager-v1.47.49.zip von deiner Downloadseite. Doppelklicke die ZIP — macOS entpackt automatisch. Benenne den Ordner in _core um und lege ihn dort ab, wo deine Projektordner liegen sollen. Empfehlung: ~/Developer Projekte/_core/ oder ~/Dokumente/Agentur/_core/.
2

Installer starten

Öffne das Terminal (Spotlight: ⌘ Space → „terminal" eingeben) und gib ein: bash ~/Developer\ Projekte/_core/install.sh. Passe den Pfad an, falls du _core/ woanders abgelegt hast. Der Installer führt dich durch Agentur-Name, LaunchAgent-Prefix, Dashboard-Port (Standard 3100), Projekte-Wurzelverzeichnis und Branchen-Paket. Am Ende mit j + Enter bestätigen.
3

Lizenz aktivieren

Beim ersten Start erscheint die Lizenzseite. Lizenzschlüssel aus der Bestätigungs-E-Mail eingeben → „Lizenz aktivieren" klicken → Dashboard öffnet sich vollständig.
4

Dashboard erkunden

Die App liegt jetzt im Dock — ein Klick öffnet das Dashboard. Wichtig: Fenster schließen (⌘W) beendet nicht den Server, er läuft weiter. Server startet automatisch bei jedem Mac-Login. Dashboard ist auch im Browser erreichbar unter http://localhost:3100.

Installer-Fragen

Was der Installer dich fragt

Beispiel-Antworten — die meisten Standardwerte einfach mit Enter übernehmen.

Agentur-Name

Beispiel: Meine Agentur GmbH. Erscheint im Dashboard-Titel.

LaunchAgent-Prefix

Standardwert mit Enter übernehmen — eindeutige ID, der Vorschlag passt.

Dashboard-Port

Enter drücken → 3100. Standard-Port, nicht ändern.

Projekte-Wurzelverzeichnis

Standardwert mit Enter übernehmen — der übergeordnete Ordner deiner Projekte.

Branchen-Paket

1 eingeben für Web- / Marketing-Agentur. Andere Pakete sind in Planung.

Am Ende erscheint eine Zusammenfassung → j + Enter zum Bestätigen. Der Installer macht danach automatisch: Konfiguration speichern · 5 Hintergrunddienste (LaunchAgents) einrichten und starten · native macOS-App bauen und in /Applications/ installieren · App dem Dock hinzufügen · Dashboard automatisch öffnen.

Fehlerbehebung

Wenn etwas hängt

node: command not found

Node.js installieren → nodejs.org.

claude: command not found

Installation per npm install -g @anthropic-ai/claude-code.

macOS-Sicherheitswarnung beim ersten Start

Rechtsklick auf App → „Öffnen" → erneut „Öffnen". Einmal bestätigen, ab dann startet die App direkt.

Dashboard öffnet sich nicht

Im Terminal prüfen: curl http://localhost:3100/api/status.

„Keine gültige Lizenz"

Einstellungen → Lizenzschlüssel prüfen und neu eingeben.

Deinstallation

Wenn du Agent Manager wieder entfernen willst

Die Deinstallation entfernt nur die Software — deine Projekte und Dateien bleiben vollständig erhalten.

Per Terminal

bash ~/Developer\ Projekte/_core/deinstall.sh

Oder im Dashboard

Einstellungen (Zahnrad) → ganz nach unten scrollen → „Agent Manager deinstallieren".

Weiter geht es

Nach der Desktop-Installation

iPhone-App installieren

Mit Agent Manager Remote hast du dein Agenten-Team auch unterwegs in der Tasche. Anleitung öffnen →

Fernzugriff einrichten

Mit Tailscale erreichst du deinen Server von überall — verschlüsselt, ohne Router-Setup. Anleitung öffnen →

Häufige Fragen

Antworten zu Voraussetzungen, Mehrgeräte-Betrieb, Sicherheit und mehr. Zur FAQ →

Desktop-App installieren (macOS)