Das Browser-Terminal nutzen

Das Browser-Terminal betreibt jeden Tab als tmux-Session auf deiner Box. Schließ den Browser, und jeder Tab läuft weiter. Screenshots einfügen, Dateien reinziehen, Dateipfade anklicken und die Seiten öffnen, nach denen dein Agent fragt: alles aus einem Fenster.

Mit Tabs arbeiten

• Wähl + neben den Tabs, um einen neuen mit dem Agenten der Box zu öffnen. Außerhalb des Terminals drückst du T.
• Doppelklick auf einen Tab benennt ihn um. Hat der Tab den Fokus, drück F2.
• Zieh einen Tab, um die Reihenfolge zu ändern, oder drück Alt+Shift+← und Alt+Shift+→.
• Wähl das × auf einem Tab, um ihn zu schließen. Das beendet die tmux-Session und stoppt jedes Programm darin, Agenten eingeschlossen.
• Wähl Vollbild am rechten Ende der Tab-Leiste.

Die Tab-Leiste zeigt, wie viele Tabs du hast, zum Beispiel 3 von 10 Tabs. Eine Box hat bis zu 10. Schließ einen, um einen neuen zu öffnen.

Bricht die Verbindung ab, zeigt das Terminal „Verbinde neu… tmux hält die Session“ und kommt von selbst zurück. Beendet sich die Shell in einem Tab, wähl Neue Shell in diesem Tab starten.

Tastenkürzel

Das Terminal reagiert wie ein lokales. Auf dem Mac gehört ⌘ dem Terminal und erreicht die Box nie, also bleibt Ctrl+C ein Interrupt, und Option funktioniert als Meta.

Unter Windows und Linux fügt ein einfaches Ctrl+V ein Bild ein. Alles andere geht als ^V an die Shell.

Rechtsklick ins Terminal öffnet ein Menü mit Kopieren, Einfügen, Alles auswählen, Leeren und Suchen. Drück ? irgendwo im Dashboard für die vollständige Liste der Tastenkürzel.

Text aus der Box kopieren

Markier Text und kopier ihn wie gewohnt. Auch Programme in der Box können deine Zwischenablage füllen. xclip und wl-copy schicken ihren Text an deinen Browser, und der Copy-Modus von tmux macht dasselbe. Das Dashboard bestätigt mit „Die Box hat Text zum Kopieren geschickt.“ So landet ein Einmalcode aus gh auth login in deiner Zwischenablage.

Screenshots in den Agenten einfügen

Füg ein Bild mit ⌘V oder Ctrl+V ein. Das Bild wird nach ~/.cache/detachbox/clipboard/ auf der Box hochgeladen, und sein Pfad wird in den Tab eingefügt. Claude Code, Codex, Gemini CLI und OpenCode machen aus diesem Pfad einen Bildanhang. Bilder dürfen bis zu 20 MB groß sein.

Dateien in die Box ziehen

Zieh Dateien von deinem Rechner aufs Terminal.

• Bilder bis 20 MB und andere Dateien bis 50 MB.
• Dateien landen unter ihrem eigenen Namen in ~/uploads/, und ihre Pfade werden in den Tab eingefügt.
• Es läuft immer nur ein Upload. Drück Esc, um ihn abzubrechen.
• Ordner werden abgelehnt. Pack den Ordner vorher als Zip oder kopier ihn mit rsync über SSH.

Im Scrollback suchen

Drück ⌘F oder Ctrl+Shift+F. Tipp zum Suchen, spring mit den Pfeil-Buttons durch die Treffer und drück Esc zum Schließen.

Links und Dateipfade öffnen

Links, die mit http beginnen, öffnen sich in einem neuen Browser-Tab. Auch Dateipfade in der Ausgabe sind Links. Öffne sie mit ⌘-Klick oder Ctrl-Klick oder tipp sie am Handy an. Ein Suffix :line wie src/app.ts:42 springt zu dieser Zeile.

Dateien im Viewer lesen

Ein Dateipfad öffnet sich im Viewer über dem Terminal. Er zeigt:

• Quellcode mit Zeilennummern und Syntax-Highlighting
• Markdown, gerendert
• Bilder und PDFs
• CSV als Tabelle
• lange Logs vom Ende her, mit Frühere Zeilen laden, um zurückzulesen

Der Viewer zeigt Dateien bis 20 MB. Herunterladen nimmt Dateien bis 1 GiB. Außerdem hat der Viewer diese Aktionen:

• Pfad kopieren kopiert den absoluten Pfad.
• Link teilen erstellt einen Link, der ohne Anmeldung für die gewählte Zeit funktioniert. Siehe Previews und Dateien.
• Gerendert öffnen zeigt eine HTML-Datei als Seite unter der Datei-Adresse der Box.
• In VS Code öffnen oder In Cursor öffnen öffnet die Datei an dieser Zeile über Remote-SSH, mit deinem eigenen SSH-Key. Am Handy gibt es diesen Button nicht.

Um eine beliebige Datei über ihren Pfad zu öffnen, drück ⌘K oder Ctrl+K und wähl Datei in … öffnen mit dem Namen der Box. Gib einen absoluten Pfad ein, einen Pfad ab deinem Home-Ordner (~/…) oder einen relativ zum Tab.

Seiten öffnen, die der Agent aufruft

Führt ein Agent detachbox-open, xdg-open oder $BROWSER aus, zeigt das Dashboard „Der Agent öffnet eine Seite:“ mit dem Host. Wähl Öffnen.

Lass Ab jetzt automatisch öffnen angehakt, und die nächsten Seiten öffnen sich von selbst. Ändern kannst du das später unter Einstellungen → Seiten, die der Agent öffnet. Die Wahl gilt pro Browser. Blockiert der Browser das Pop-up, erlaub Pop-ups für my.detachbox.com.

Ein Link auf localhost:<port> der Box selbst öffnet sich als Preview-URL der Box.

Theme und Textgröße wählen

Das Dashboard folgt System, Hell oder Dunkel, einzustellen unter Einstellungen → Darstellung. Agenten zeichnen ihre Screens für ein dunkles Terminal, deshalb ist Terminal bleibt dunkel standardmäßig an. Schalte es aus, wenn du im hellen Theme ein helles Terminal willst.

Die Textgröße änderst du mit ⌘+ und ⌘− auf dem Mac oder über das Befehlsmenü unter ⌘K. Am Handy ziehst du mit zwei Fingern auf oder zu.

Alle Tabs auf einmal im Blick

Drück Ctrl+` (die Backtick-Taste), um die Terminals-Liste neben jeder Seite ein- oder auszublenden. Alt+1 bis Alt+9 springen zu einem Terminal in der Liste. Auf dem Mac nimmst du Option. Die Liste markiert Agenten, die dich brauchen, wie Benachrichtigungen erklärt.