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 jsonoderdevenv 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
- Chats — Sitzungen ohne Projekt, für schnelle Fragen
- Projektnotizen, Todos & Pläne — Arbeitsnotizen pro Projekt behalten
- Projektaktionen — Befehle speichern, die du oft ausführst
- Kontext — sehen, wie viel des Modellgedächtnisses eine Session verbraucht