Dein erster Agent-Run

Am Ende dieses Tutorials hast du einen KI-Coding-Agent gegen ein Projekt gestartet, ihn im Live-Modus bei der Arbeit beobachtet und abgelesen, was der Run gekostet hat. Es dauert etwa zehn Minuten und setzt voraus, dass du dich bereits in einem SupaCloud-Workspace mit mindestens einem Projekt anmelden kannst.

Voraussetzungen

• Ein SupaCloud-Konto in einem Workspace (admin@example.com, wenn du gerade self-gehostet hast).
• Ein Projekt in diesem Workspace. Jedes Git-Projekt funktioniert.

1. Das Cockpit öffnen

Nach der Anmeldung landest du auf dem Dashboard — dem Operator-Cockpit. Es zeigt deine aktiven und wartenden Runs und einen Live-Run-Stream, dazu Panels für die Runner-Flotte, die Kosten und eine Aufmerksamkeits-Queue. Hier taucht jeder Run auf, den du startest.

Neuer Workspace? Das Dashboard führt dich

Bei einem brandneuen Workspace begrüßt dich das Dashboard mit einer kurzen Erste-Schritte-Checkliste — Modell-Harness verbinden, Git-Zugang hinterlegen, Projekt anlegen, ersten Run starten, in dieser Reihenfolge (credentials-first). Die passende Harness-Anmeldung wird automatisch genutzt (kein Zuordnungsschritt), optionale MCP- und Skill-Schritte halten sich zurück. Wenn du sie abschließt, graduiert der Workspace und die Onboarding-Autonomie-Grenze fällt, sodass die Autonome Auslieferung selbstständig zu dispatchen beginnt. Dieses Tutorial behandelt denselben Weg im Detail.

2. Einen Run aus dem Web-Terminal starten

SupaCloud bringt ein Web-Terminal unter /cli mit, das dieselbe Service-Schicht wie die UI ansteuert. Es ist der schnellste Weg, deinen ersten Run zu starten.

1. Öffne /cli über die Seitenleiste (oder navigiere direkt dorthin).

2. Liste deine Projekte auf, um den Zielnamen zu bestätigen:

   projects

3. Starte einen Run. Der Befehl run nimmt ein Projekt, einen Agent und einen Prompt — und versetzt dich direkt in den Live-Modus:

   run my-project claude "Füge einen /health-Endpoint hinzu, der 200 und den Build-SHA zurückgibt"

   • my-project — der Projektname aus Schritt 2.
   • claude — der zu verwendende Agent.
   • alles danach — der Prompt für den Agent.

Stattdessen aus einem Issue starten

Wenn die Arbeit schon als Tracker-Issue existiert, seede den Prompt daraus mit run my-project claude --issue 42. Siehe Einen Task aus einem Issue starten.

3. Den Run live verfolgen

Nach run ist das Terminal im Live-Modus: das Denken des Agents, seine Tool-Aufrufe und Nachrichten erscheinen in Echtzeit. Im Live-Modus brauchst du kein Befehlspräfix — tippe einfach und drücke Enter, um dem Agent eine Intervention zu senden. Mit Strg+C verlässt du den Live-Modus, ohne den Run zu stoppen.

Wieder einsteigen kannst du jederzeit mit der Run-ID:

follow <id>

Du kannst auch von außerhalb des Live-Modus eingreifen — mit intervene <id> <nachricht> — oder einen Run mit cancel <id> stoppen.

4. Ergebnis und Kosten ablesen

Wenn der Agent fertig ist, öffne seine Run-Detail-Seite — klicke den Run im Dashboard oder in der Runs-Liste an, um ihn als Peek zu öffnen, dann im Drawer-Header auf Task öffnen (bzw. Workflow öffnen) klicken, um die vollständige Detail-Seite zu öffnen (jeder Run ist auch eine deep-linkbare URL). Das Panel zeigt Auslöser, Dauer, Start- und Endzeitpunkt, den Container, den der Run verwendet hat, und — direkt in der Header-Metazeile — die Agent-Kosten in USD. Du musst die UI dafür nicht verlassen.

Dieselben Werte — Status, Kosten, Dauer und letzte Aktivität — gibt es auch im Web-Terminal, falls du die Tastatur bevorzugst:

task <id>

Was du gelernt hast

• Das Dashboard ist das Cockpit für jeden Run.
• run <project> <agent> <prompt> startet eine Task und öffnet den Live-Modus.
• Im Live-Modus sendet Enter eine Intervention; Strg+C beendet ihn.
• Das Run-/Task-Detail-Panel zeigt Status, Dauer, Zeitstempel und Kosten direkt in der UI; das Web-Terminal task <id> zeigt dasselbe.

Nächste Schritte

• Einen Task aus einem Issue starten
• Web-Terminal-Befehlsreferenz
• Workspaces und Organisationen