detachbox
SeitenDateien, Screenshots und Fotos

Dateien, Screenshots und Fotos

Zeig dem Agenten einen Bug so, wie du ihn einem Kollegen zeigen würdest: Füg den Screenshot ein, und der Agent bekommt seinen Pfad und liest ihn. In die andere Richtung geht es genauso leicht. Klick auf einen Pfad, den der Agent ausgibt, und die Datei öffnet sich in einem Viewer über dem Terminal, bereit zum Lesen, Herunterladen oder Teilen.

Screenshots in den Agenten einfügen

Kopier einen Screenshot und drück ⌘V oder Ctrl+V im Terminal. Das Bild landet in /uploads/clipboard/ dieses Terminals, und sein Pfad steht am Cursor; Claude Code, Codex und OpenCode machen aus diesem Pfad einen Bildanhang.

  • Bilder bis 20 MB gehen als Bild an den Agenten; ein größeres geht als Datei hoch.
  • Beim Hochladen wird das Bild zu einem WebP mit höchstens 2500 px an der langen Seite, passend für die Agenten: um ein Vielfaches kleiner als der Screenshot und für den Agenten gleichwertig. Wo WebP nicht verfügbar ist, geht es als JPEG, und ein Bild, das nicht kleiner würde, geht so, wie es ist.
  • Eine in Finder oder Explorer kopierte Datei fügst du genauso ein: ⌘V lädt die Datei selbst hoch.
  • Auch Claude Code fügt Bilder selbst ein: Drück Ctrl+V in Claude Code, und es findet das Bild, das du gerade eingefügt hast.

Beim ersten Einfügen fragt der Browser vielleicht nach Zugriff auf die Zwischenablage; das Terminal zeigt auf die Abfrage an der Adressleiste. Verweigert der Browser der Seite die Zwischenablage, erlaube sie in den Website-Einstellungen und füg erneut ein.

Dateien aufs Terminal ziehen

Zieh Dateien von deinem Rechner aufs Terminal; es zeigt „Zum Hochladen in dieses Terminal ablegen“.

  • Dateien bis zum Limit deines Tarifs: 100 MB bei Start, 250 MB bei Pro, 500 MB bei Max, 1 GB bei Business, 2 GB bei Business Plus, 5 GB bei Business Max, 10 GB bei Business Ultra.
  • Dateien gehen direkt ins Terminal, in Stücken. Reißt deine Verbindung ab, wartet der Upload und macht beim letzten angekommenen Stück weiter; nichts fängt von vorn an.
  • Zieh mehrere auf einmal hinein: Ihre Pfade werden in einer Zeile eingefügt, durch Leerzeichen getrennt und für die Shell maskiert, wo ein Name das braucht.
  • Bilder bis 20 MB kommen zu den eingefügten nach /uploads/clipboard/. Andere Dateien landen unter ihrem eigenen Namen in /uploads/; eine zweite Datei gleichen Namens wird zu name (1).ext.
  • Einen Ordner nimmt das Terminal nicht an: Pack ihn als zip und zieh die zip-Datei hinein, oder zieh die Dateien darin hinein.

Fotos vom Handy schicken

Tipp auf Foto einfügen in der Tastenleiste unter dem Terminal. Das Handy bietet seine Mediathek, die Kamera und seine Dateien an; wähl ein Foto oder mehrere.

  • Ein iPhone-Foto in HEIC wird unterwegs zu einem JPEG, weil kein Agent HEIC liest. AVIF, BMP und TIFF werden zu PNG.
  • Ein Foto größer als 4096 × 4096 wird passend verkleinert.
  • Ein Foto, das der Browser nicht umwandeln kann, bleibt auf dem Handy, und das Terminal sagt dir, welches.

Der Button Einfügen in der Tastenleiste fügt auch ein Bild aus der Zwischenablage des Handys ein. Handy erklärt den Rest der Tastenleiste.

Einen Upload verfolgen und abbrechen

Eine Fortschrittsanzeige über dem Terminal zeigt „Bild wird eingefügt…“ oder „report.pdf wird hochgeladen…“ mit dem Fortschritt in Prozent. Drück Esc oder wähl Abbrechen, um ihn zu stoppen; der schon gesendete Teil wird aus dem Terminal entfernt. Es läuft immer nur ein Ablegen, und davon laden drei Dateien gleichzeitig hoch. Solange die Verbindung weg ist, zeigt die Anzeige „Verbindung weg. Es geht dort weiter, wo es stand…“, und der Upload läuft von selbst weiter, sobald du wieder online bist.

Wo Uploads liegen

Nur dieses Terminal sieht seine Uploads, und sie verschwinden, wenn es endet oder neu startet. Von eingefügten Bildern bleiben die neuesten 50 der letzten 24 Stunden: Jedes neue Einfügen räumt ältere weg. Verschieb eine Datei ins Projekt, um sie zu behalten.

Dateipfade aus der Ausgabe öffnen

Pfade, die der Agent ausgibt, werden zu Links, sobald die Datei existiert: Sie werden unterstrichen, wenn du darauf zeigst. Öffne einen mit ⌘-Klick oder Ctrl-Klick oder tipp ihn auf dem Handy an.

  • Absolute Pfade, ~/…, ./…, ../… und Pfade wie src/app.ts.
  • Ein Suffix :line oder :line:col, etwa src/app.ts:42, öffnet die Datei an dieser Zeile. Ein bloßer Name wie app.ts wird zum Link, wenn eine Zeilennummer angehängt ist.
  • Relative Pfade beziehen sich auf den Ordner, in dem die Shell gerade ist.
  • file://-Links und die Links, die ls --hyperlink ausgibt, öffnen sich auch im Viewer; Web-Links öffnen sich in einem neuen Browser-Tab.

Eine beliebige Datei per Pfad öffnen

Wähl Datei öffnen… im Befehlsmenü unter ⌘K oder auf der Seite Dateien und Vorschauen des Terminals. Tipp einen absoluten Pfad, einen Pfad ab deinem Home (~/…) oder einen relativ zum Ordner des Terminals ein; häng :line an, um dorthin zu springen.

Dateien im Viewer lesen

Der Viewer öffnet sich über dem Terminal; auf dem Handy nimmt er den ganzen Bildschirm ein. Sein Kopf zeigt den Ordner der Datei, ihre Größe und wann sie sich geändert hat, und Esc schließt ihn.

  • Code mit Zeilennummern und Hervorhebung für 25 Sprachen, darunter Dockerfiles und Makefiles; ein :line-Link zeigt diese Zeile in der Mitte und markiert sie.
  • Markdown, gerendert wie auf GitHub. Rohes HTML darin wird übersprungen, und Bilder erscheinen als ihr Alt-Text.
  • Bilder und PDFs. Auf einem Handy, das nur die erste Seite eines PDFs zeigt, wähl In neuem Tab öffnen.
  • CSV und TSV als Tabelle, die ersten 1.000 Zeilen.
  • Lange Logs: Eine Datei über 1 MB öffnet sich bei ihren letzten 256 KB, und Frühere Zeilen laden lädt jeweils die vorherigen 256 KB.
  • HTML als Quelltext, mit Gerendert öffnen, um die Seite zu sehen.
  • Alles andere: Größe und Typ, mit Herunterladen.

Ein Ordnerpfad zeigt „Das ist ein Ordner“, mit Auf dem Files-Host öffnen für eine Liste von bis zu 2.000 Einträgen.

Der Viewer zeigt Dateien bis 20 MB an; mit Herunterladen lädst du Dateien bis 1 GiB herunter. Pfad kopieren kopiert den absoluten Pfad.

  1. Öffne die Datei im Viewer und wähl Link teilen.
  2. Wähl unter Der Link gilt für 15 Minuten, 1 Stunde, 1 Tag oder 7 Tage.
  3. Wähl Link erstellen und dann Link kopieren.

Jeder mit dem Link kann genau diese eine Datei herunterladen, ohne Konto, bis die Zeit um ist. Die Seite Dateien und Vorschauen des Terminals listet seine Links unter Geteilte Dateien: wie oft jeder geöffnet wurde (zeig auf die Zahl für das letzte Mal), wann er abläuft, einen Button, um ihn erneut zu kopieren, und Widerrufen, um ihn vorzeitig zu beenden. Ein Terminal hält bis zu 50 aktive Links. Seine Links überstehen einen Neustart und enden mit dem Terminal.

Deine Dateien im Browser öffnen

Jedes Terminal hat eine Dateiadresse: https://files-<terminal ID>.detachbox.dev/<absolute path>. Sie liefert aus, was dieses Terminal lesen kann, mit derselben Anmeldung wie Previews. Gerendert öffnen zeigt von dort einen HTML-Bericht oder eine gebaute Site als Seite. Eine solche Seite erreicht nur die Dateien unter ihrem eigenen Ordner und nie Dateien, deren Namen mit einem Punkt beginnen, etwa .env, .git oder .detachbox.