Der Dateibrowser

📁 Browse files (Dateien durchsuchen) zeigt die Dateien auf dem Rechner des Relays, ohne dass du die Konversation verlässt: den Ordner, in dem der Agent arbeitet, den Rest des Rechners und den Ordner, den die Session des Agents selbst führt. Du nutzt ihn, um zu sehen, was der Agent geändert hat, um eine Datei zu öffnen, um einen Verweis für deine nächste Nachricht zu kopieren und um aufzuräumen. Derselbe Browser wählt einen Ordner, wenn du eine Konversation startest oder ihren Arbeitsordner änderst.

Öffnen #

Der Browser öffnet sich als Dialog über der Konversation. Sein Titel sagt dir, in welcher Wurzel du bist: Repository Browser (Repository-Browser), Drives Browser (Laufwerksbrowser) oder Session Browser (Session-Browser). Schließ ihn mit × oder Escape.

Auf einem Desktop hat der Dialog zwei Bereiche nebeneinander. Der linke Bereich, File tree (Dateibaum), zeigt nur Ordner. Der rechte Bereich zeigt die Dateien des offenen Ordners, mit einer Pfadleiste darüber. Auf einem Handy liegen die beiden Bereiche übereinander, der Baum oben. Klick einen Ordner im Baum an, um ihn zu öffnen. ⌖ Focus (Fokussieren) klappt den Baum bis auf den offenen Ordner zu. Ein Zähler daneben zeigt, wie viele Einträge der Baum enthält, zum Beispiel 12 nodes im Workspace und 12 entries anderswo.

List und Icons (Liste / Symbole) schalten den Dateibereich zwischen Zeilen und Karten um. Karten zeigen bei Bildern ein Vorschaubild.

Die drei Wurzeln #

Drei Buttons links in der Werkzeugleiste wählen, was der Browser zeigt.

Welcher Ordner der Workspace ist #

Die Workspace-Wurzel ist der Arbeitsordner der Konversation. Sie folgt der Konversation, die du offen hast, und eine laufende Session behält den Ordner, in dem sie wirklich arbeitet. 🗂️ Change CWD (Arbeitsordner ändern) im ⋯-Menü der Konversation verschiebt ihn für den nächsten Start des Agents oder sofort mit 🚀 Set new CWD and (re)launch (Neuen Arbeitsordner setzen und neu starten); siehe Später ändern. Ändert sich der Arbeitsordner, verwirft der Browser, was er offen hatte, und zeigt den neuen Ordner. Ein cd in einer Chat-Nachricht bewegt den Browser nicht.

Ein Claude-Cloud-Chat hat keinen Arbeitsordner auf deinem Rechner und keinen Dateibrowser: Der Agent arbeitet auf einem Klon bei Anthropic.

Laufwerke und der Session-Ordner #

Die Laufwerkswurzel erreicht den ganzen Rechner, nicht nur den Arbeitsordner. Die Erlaubnisliste, die begrenzt, wo ein Chat starten darf (workspaceRootAllowList, siehe Begrenzen, wo Chats starten dürfen), begrenzt nicht, was du durchsuchen kannst.

Der Session-Ordner listet die Dateien, die der Provider des Agents für diese Session führt. Du kannst sie ansehen und öffnen. Im Session Browser bietet der Browser nur New folder (Neuer Ordner) an: kein Rename (Umbenennen) und kein Delete (Löschen). Das ist eine Regel der Seite, nicht des Relays. Derselbe Ordner, über 📀 geöffnet, bietet Rename und Delete an, und das Relay lehnt sie nicht ab.

Die Werkzeugleiste #

Hidden und Heavy sind beim ersten Mal beide aus. Ein versteckter Name, der auch groß ist, braucht beide Schalter. Eine Änderung wirkt sofort und aktualisiert den Baum.

Dein Browser merkt sich die Filter: Hidden für den Workspace, Hidden für die Laufwerks- und die Session-Wurzel (eine Einstellung für beide) und Heavy. Er merkt sich nicht die Wurzel, die Ansicht oder welche Ordner offen waren; das hält, solange die Seite offen bleibt, und übersteht Refresh sowie Schließen und erneutes Öffnen des Dialogs, aber nicht das Neuladen der Seite.

Eine Datei öffnen #

Klick eine Datei im Dateibereich an, um sie im Datei-Viewer zu öffnen. In der Ordnerauswahl (unten) lassen sich keine Dateien öffnen.

Auf eine Datei oder einen Ordner in deiner Nachricht verweisen #

Zwei Bedienelemente kopieren einen Verweis in die Zwischenablage, in Backticks gesetzt. Sie fügen ihn nicht in den Eingabebereich ein: Du fügst ihn selbst in deine Nachricht ein.

Im Workspace ist der Pfad relativ zum Arbeitsordner, etwa @folder:src/components. In der Laufwerks- und der Session-Wurzel ist es der volle Pfad auf dem Rechner. Was der Agent für einen Verweis bekommt und wie Bilder angehängt werden, steht unter Dateiverweise.

Ordner und Dateien #

Neu in 0.9.10 Du kannst Ordner anlegen, Dateien und Ordner umbenennen und sie löschen. Das geht im Workspace und auf den Laufwerken. Im Session-Ordner bietet der Browser nur neue Ordner an.

Neuer Ordner #

📁+ New folder öffnet oben im Dateibereich ein Namensfeld. Gib den Namen ein und drück Enter: Der Ordner wird im offenen Ordner angelegt, und der Browser öffnet ihn. Escape bricht ab. Ein Hinweis sagt Folder "name" created. Ein Name, der schon vergeben ist oder den das System ablehnt, wird unter dem Feld gemeldet, und das Feld bleibt offen. Der Button ist deaktiviert, solange nichts einen Ordner aufnehmen kann, etwa in der Windows-Liste der Laufwerke.

Das Kontextmenü #

Klick mit rechts auf einen Ordner im Baum oder eine Datei im Dateibereich. Auf einem Handy drückst du lange. Das Menü bietet:

Umbenennen und Delete werden für eine Wurzel (den Arbeitsordner, / oder ein Laufwerk) nicht angeboten, ebenso wenig für irgendetwas im Session Browser. Ein umbenannter Ordner behält seinen Platz im Baum und bleibt offen.

Löschen #

Delete fragt zuerst beim Relay nach, was wegfallen würde, und der Dialog sagt es dir, bevor etwas entfernt wird:

Bei einem Ordner mit Inhalt bleibt der rote 🗑 Delete-Button deaktiviert, bis du den Namen des Ordners in das Feld Type the folder name to confirm (Zum Bestätigen den Ordnernamen eingeben) tippst. Löschen entfernt die Datei oder den Ordner von der Festplatte; nichts landet in einem Papierkorb.

Namen und Links #

• Ein Name ist ein einzelnes Segment: Er darf nicht leer, . oder .. sein, darf kein / oder \ enthalten und ist höchstens 255 Byte lang.
• Läuft das Relay unter Windows, darf ein Name außerdem weder < > : " | ? * noch Steuerzeichen enthalten, nicht auf einen Punkt oder ein Leerzeichen enden und kein Name sein, den Windows reserviert, etwa con oder nul.
• Namen werden exakt verglichen: Ein Name, den es im Ordner schon gibt, wird mit That name is already taken abgelehnt. Nur die Groß- und Kleinschreibung eines Namens zu ändern, ist erlaubt.
• Ein Link (ein symbolischer Link) wird nie umbenannt oder gelöscht: Das Relay lehnt ihn mit Links cannot be changed here ab. Der Workspace-Baum listet keine Links. Unter Linux und macOS listen die Laufwerks- und die Session-Wurzel sie, und ein Link auf einen Ordner erscheint als Ordner, sodass du ihn öffnen und durch ihn lesen kannst; geschützt ist nur der Link selbst. Ein Pfad, der über einen Link auf einen Ordner führt, erreicht weiterhin den Ordner dahinter. Im Workspace wird ein Link, der aus dem Arbeitsordner herausführt, als ungültiger Pfad abgelehnt.
• Eine Änderung, die das Betriebssystem nicht erlaubt, wird als Permission denied gemeldet. Ein abgelehntes Umbenennen oder Löschen erscheint als Hinweis; ein abgelehnter neuer Ordner erscheint unter dem Namensfeld.

Als Ordnerauswahl #

Derselbe Browser wählt einen Ordner für New chat (Neuer Chat) und für 🗂️ Change CWD: Drück 📁 neben dem Pfadfeld. Der Browser öffnet sich in der Laufwerkswurzel, eine Leiste unten zeigt den gewählten Ordner (oder Select a folder…), und ✅ Use this folder as CWD (Diesen Ordner als Arbeitsordner verwenden) gibt ihn zurück. Die drei Wurzeln bleiben verfügbar. In diesem Modus öffnen sich keine Dateien, und Rename und Delete werden nicht angeboten; 📁+ New folder und 📁 New folder here funktionieren, sodass du einen Projektordner anlegen und in einem Zug auswählen kannst. Siehe Der Arbeitsordner.

Grenzen #

• Der Workspace-Baum lädt jeweils einen Ordner, wenn du ihn öffnest. Versteckte und große Namen bleiben außen vor, bis du sie einschaltest.
• Ein Ordner, den das Relay nicht lesen kann, öffnet sich leer, statt einen Fehler zu zeigen. Einträge, die es nicht lesen kann, fehlen in der Liste.
• Die Session-Wurzel ist bei einer Claude- oder DeepSeek-Session, die noch keine Dateien geschrieben hat, leer und kein Fehler.

Nach Provider #

Der Browser ist für jeden Provider gleich, der in einem Ordner auf dem Rechner des Relays arbeitet. Unterschiedlich ist der Session-Ordner hinter 🕵️.