Tasks

Ein Task ist ein Auftrag für einen Agenten in einem Projekt. Er bekommt einen eigenen Branch und in jedem Repo, das er anfasst, einen eigenen Worktree, damit parallel arbeitende Agenten einander nicht in die Quere kommen und die Hauptordner der Repos unberührt bleiben.

Neuer Task…

Neuer Task… (⌘N oder der Knopf oben im Fenster) fragt nach:

• Projekt: das Projekt, zu dem der Task gehört.
• Repos: die Repos, in denen er arbeitet, als Chips. Ein Projekt mit einem Repo hat es gewählt; mit keinem oder mehreren arbeitet der Task über mehrere Repos.
• Auftrag: was passieren soll. Beschreib das Ergebnis, nicht die Schritte. Zieh Bilder ins Fenster, füge ein Bildschirmfoto ein oder häng Dateien mit der Büroklammer an; der Agent bekommt ihre Pfade mit dem Auftrag. Das Mikrofon startet das Diktieren von macOS.
• Agent: Claude Code, Codex, opencode, Gemini CLI oder eine Shell. Bei Claude Code und Codex zeigt das Fenster die aktuelle Fünf-Stunden-Nutzung und wann sie wieder frei ist.
• Vorgehen: Sofort starten, oder mit Claude Code Erst planen.
• Branch: Das Präfix kommt aus den Projekt-Einstellungen, du tippst nur den Rest. Bleibt das Feld leer, wird der Branch nach dem Auftrag benannt.
• Basis und Server: der Branch, von dem er ausgeht, und wo er läuft.

Starten legt den Branch an, hier feature/ und die ersten Wörter des Auftrags, und den Worktree unter ~/.cavvy/worktrees. Das Präfix änderst du je Projekt unter Projekt-Info → Einstellungen → Tasks.

Der Worktree ist ein normaler Ordner. Öffne ihn in deinem Editor, führ darin etwas aus, sieh dich um: Er gehört dir so sehr wie dem Agenten.

Vom neuesten Stand starten

Basis vorher von origin pullen holt den Basis-Branch von origin, bevor der Task startet, damit der Agent nicht auf dem Code von gestern arbeitet. Cavvy geht dabei nur vorwärts; wo das nicht geht, startet der Task vom lokalen Branch und sagt es dir. Die Voreinstellung legst du je Projekt unter Projekt-Info → Einstellungen → Tasks fest, im Fenster für den neuen Task kannst du sie abschalten.

Einrichtung

Ein frischer Worktree enthält nur, was git verfolgt: kein node_modules, kein .venv, kein vendor. Einrichtung, auf der Seite des Repos unter Einstellungen, listet Befehle, die im neuen Worktree laufen, bevor der Agent startet. Unter Gefunden: schlägt Cavvy sie aus den Lockfiles des Repositorys vor:

Die Befehle laufen nacheinander in einem Seitenterminal namens Einrichtung, das offen bleibt, damit du lesen kannst, wie es ausging. Der Agent wartet so lange; die Karte sagt es und bietet Jetzt starten, damit der Agent schon beginnt, während die Einrichtung weiterläuft.

Scheitert ein Befehl, startet der Agent trotzdem, und der Task wandert mit Einrichtung fehlgeschlagen unter Probleme. Einrichtung zeigen öffnet das Seitenterminal, Ausblenden nimmt den Task aus den Problemen.

Die Befehle liegen in der git-Konfiguration des Repositorys, nicht in einem Commit.

Ignorierte Dateien mitnehmen: .worktreeinclude

Kleine ignorierte Dateien, die ein Task braucht, etwa eine lokale Werkzeug-Konfiguration, können mitkommen. Nenn sie in einer .worktreeinclude im Repository, mit derselben Syntax wie .gitignore:

$ mise.toml
.env.local

Cavvy kopiert die Dateien, die zu einem Muster passen und von git ignoriert werden, bevor die Einrichtung läuft. Auf dem Mac klont es sie (Copy-on-Write), selbst große Ordner kosten so keinen Platz. Ohne .worktreeinclude wird nichts kopiert: Geheimnisse ungefragt zu kopieren wäre der falsche Standard.

Während der Agent arbeitet

Der Task steht unter Arbeitet. Fragt der Agent etwas oder hält er an, bevor er cavvy done aufgerufen hat, wandert er nach Braucht dich; ist er mit neuen Commits fertig, prüft Fertig heißt die Arbeit. Die drei Reiter des Tasks zeigen Terminal, Änderungen und Verlauf. ⌘J öffnet ein Seitenterminal im selben Worktree.

In einem Task sagt Cavvy Claude Code und Codex, dass sie auf dem Branch des Tasks committen sollen, aber nicht mergen, pushen oder Merge Requests öffnen. Den genauen Wortlaut findest du unter Was Cavvy an Agenten ändert.

Wenn er fertig ist

Sieh dir die Änderungen im Review-Fenster an, gib sie bei Bedarf mit Notizen zurück und beende den Task mit Abschließen….