Zum Inhalt springen
↑↓Navigieren ↵Öffnen escSchließen

Projekte

Ein Projekt ist ein Ordner auf deinem Computer, den OpenChamber im Blick behält — normalerweise eine Codebasis. Wenn du das Projekt wechselst, wechselt der Ordner, in dem der Agent arbeitet, zusammen mit den Sessions und Einstellungen dieses Projekts.

Ein Projekt hinzufügen

Du kannst ein Projekt an ein paar Stellen hinzufügen:

  • der Eintrag Projekt hinzufügen in der Befehlspalette
  • die Schaltfläche + oben in der Session-Seitenleiste
  • der Ordnerbrowser, wenn du ein Verzeichnis auswählst

Zeige auf einen Ordner, und OpenChamber merkt ihn sich. Der Name kommt vom Ordner; du kannst ihn später ändern.

Projekte wechseln

Wähle ein Projekt in der Seitenleiste aus, um es aktiv zu machen. Alles — Sessions, Git, Notizen — folgt dem Projekt, das du geöffnet hast.

Ein Projekt wiedererkennbar machen

Öffne Einstellungen → Projekte, um einem Projekt einen eigenen Namen, eine Farbe oder ein Symbol zu geben. OpenChamber versucht, automatisch ein Symbol zu finden — siehe Projekt-Symbole.

In VS Code verwendet OpenChamber immer den Ordner, den du geöffnet hast, als einziges Projekt. Es gibt dort also nichts hinzuzufügen oder umzuschalten. Die Seite mit den Projekteinstellungen ist dort ausgeblendet.

Projektumgebung

Wenn die Werkzeuge eines Projekts aus direnv, devenv oder einer Nix-Shell kommen, finden Git-Hooks, das Terminal und Projektaktionen sie nicht von selbst. Öffne Einstellungen → Projekte und wähle das Projekt aus. Unter Umgebung kannst du:

  • Variablen hinzufügen, die nur dieses Projekt braucht
  • oder einen Umgebungsbefehl festlegen, der sie ausgibt, zum Beispiel direnv export json oder devenv print-dev-env --json

Der Befehl läuft im Projektordner und für einen Worktree in dessen eigenem Ordner. Er läuft erneut, wenn du committest, ein Terminal öffnest oder eine Aktion ausführst und der letzte Lauf ein paar Minuten zurückliegt, und Erneut ausführen startet ihn sofort. Nur weil das Projekt geöffnet ist, läuft er nicht. Unter dem Feld siehst du, wie viele Variablen der letzte Lauf hinzugefügt hat oder warum er fehlgeschlagen ist. Ein fehlgeschlagener Lauf fügt nichts hinzu, und Git und das Terminal arbeiten ohne ihn weiter.

Diese Variablen gehen an Git, das Terminal und Projektaktionen, zusätzlich zu denen unter Einstellungen → Allgemein → Umgebungsvariablen (siehe Umgebungsvariablen). OpenCode bedient alle Projekte aus einem einzigen Prozess und bekommt deshalb keine Projektvariablen: Was der Agent braucht, gehört in die allgemeine Liste.

Den Befehl legst nur du fest. Er wird nicht aus dem Repository gelesen, ein geklontes Repository kann OpenChamber also nichts ausführen lassen.

Verwandtes