Utiliser le terminal du navigateur

Le terminal du navigateur fait tourner chaque onglet comme une session tmux sur votre box. Fermez le navigateur : chaque onglet continue de tourner. Collez des captures d’écran, déposez des fichiers, cliquez sur des chemins de fichiers et ouvrez les pages que votre agent demande, le tout depuis une seule fenêtre.

Travailler avec les onglets

• Choisissez + à côté des onglets pour en ouvrir un nouveau avec l’agent de la box. Hors du terminal, appuyez sur T.
• Double-cliquez sur un onglet pour le renommer. Appuyez sur F2 quand l’onglet a le focus.
• Faites glisser un onglet pour le déplacer, ou appuyez sur Alt+Shift+← et Alt+Shift+→.
• Choisissez le × d’un onglet pour le fermer. La fermeture met fin à la session tmux et arrête tous les programmes qu’elle contient, agents compris.
• Choisissez Plein écran au bout de la barre d’onglets, à droite.

La barre d’onglets indique combien d’onglets vous avez, par exemple 3 onglets sur 10. Une box en accueille jusqu’à 10. Fermez-en un pour en ouvrir un autre.

Quand la connexion tombe, le terminal affiche « Reconnexion… tmux garde la session » et revient de lui-même. Si le shell d’un onglet se termine, choisissez Lancer un nouveau shell dans cet onglet.

Raccourcis clavier

Le terminal répond comme un terminal local. Sur Mac, ⌘ est la touche du terminal et n’atteint jamais la box : Ctrl+C reste une interruption et Option fait office de Meta.

Sous Windows et Linux, un simple Ctrl+V colle une image. Tout le reste part au shell sous forme de ^V.

Faites un clic droit sur le terminal pour un menu avec copier, coller, tout sélectionner, effacer et rechercher. Appuyez sur ? n’importe où dans le tableau de bord pour la liste complète des raccourcis.

Copier du texte hors de la box

Sélectionnez du texte et copiez-le comme d’habitude. Les programmes de la box peuvent aussi remplir votre presse-papiers. xclip et wl-copy envoient leur texte à votre navigateur, et le mode copie de tmux fait de même. Le tableau de bord le confirme par « La box a envoyé du texte à copier. » C’est ainsi qu’un code à usage unique de gh auth login arrive dans votre presse-papiers.

Coller des captures d’écran dans l’agent

Collez une image avec ⌘V ou Ctrl+V. L’image est envoyée dans ~/.cache/detachbox/clipboard/ sur la box, et son chemin est collé dans l’onglet. Claude Code, Codex, Gemini CLI et OpenCode transforment ce chemin en image jointe. Les images peuvent aller jusqu’à 20 MB.

Déposer des fichiers dans la box

Faites glisser des fichiers de votre ordinateur sur le terminal.

• Images jusqu’à 20 MB, autres fichiers jusqu’à 50 MB.
• Les fichiers arrivent dans ~/uploads/ sous leur propre nom, et leurs chemins sont collés dans l’onglet.
• Un seul envoi à la fois. Appuyez sur Esc pour l’annuler.
• Les dossiers sont refusés. Compressez d’abord le dossier en zip, ou copiez-le avec rsync via SSH.

Rechercher dans l’historique

Appuyez sur ⌘F ou Ctrl+Shift+F. Tapez pour chercher, parcourez les résultats avec les flèches et appuyez sur Esc pour fermer.

Ouvrir des liens et des chemins de fichiers

Les liens qui commencent par http s’ouvrent dans un nouvel onglet du navigateur. Les chemins de fichiers dans la sortie sont aussi des liens. Faites ⌘-clic ou Ctrl-clic dessus, ou touchez-les sur un téléphone. Un suffixe :line, comme src/app.ts:42, mène directement à cette ligne.

Lire des fichiers dans la visionneuse

Un chemin de fichier s’ouvre dans la visionneuse, par-dessus le terminal. Elle affiche :

• le code source avec numéros de ligne et coloration syntaxique
• le markdown, mis en forme
• les images et les PDF
• les CSV sous forme de tableau
• les longs journaux depuis la fin, avec Charger les lignes précédentes pour remonter

La visionneuse affiche les fichiers jusqu’à 20 MB. Télécharger prend les fichiers jusqu’à 1 GiB. La visionneuse propose aussi ces actions :

• Copier le chemin copie le chemin absolu.
• Partager un lien crée un lien qui fonctionne sans connexion pendant la durée choisie. Voir Aperçus et fichiers.
• Ouvrir en tant que page affiche un fichier HTML comme une page, sur l’adresse de fichiers de la box.
• Ouvrir dans VS Code ou Ouvrir dans Cursor ouvre le fichier à cette ligne via Remote-SSH, avec votre propre clé SSH. Ce bouton n’apparaît pas sur téléphone.

Pour ouvrir n’importe quel fichier par son chemin, appuyez sur ⌘K ou Ctrl+K et choisissez Ouvrir un fichier dans suivi du nom de la box. Saisissez un chemin absolu, un chemin depuis votre dossier personnel (~/…) ou un chemin relatif à l’onglet.

Gérer les pages que l’agent ouvre

Quand un agent lance detachbox-open, xdg-open ou $BROWSER, le tableau de bord affiche « L’agent ouvre une page : » avec l’hôte. Choisissez Ouvrir.

Laissez Ouvrir automatiquement désormais coché, et les pages suivantes s’ouvrent d’elles-mêmes. Modifiez ce choix plus tard dans Paramètres → Pages ouvertes par l’agent. Le choix vaut pour chaque navigateur. Si le navigateur bloque la fenêtre, autorisez les pop-ups pour my.detachbox.com.

Un lien vers le localhost:<port> de la box s’ouvre sur l’URL d’aperçu de la box.

Choisir un thème et une taille de texte

Le tableau de bord suit Système, Clair ou Sombre, à régler dans Paramètres → Apparence. Les agents dessinent leurs écrans pour un terminal sombre : Le terminal reste sombre est donc activé par défaut. Désactivez-le pour un terminal clair avec le thème clair.

La taille du texte se règle avec ⌘+ et ⌘− sur Mac, ou depuis le menu de commandes ⌘K. Sur téléphone, pincez avec deux doigts.

Surveiller tous les onglets à la fois

Appuyez sur Ctrl+` (la touche accent grave) pour afficher ou masquer la liste des terminaux à côté de n’importe quelle page. Alt+1 à Alt+9 mènent à un terminal de la liste. Sur Mac, utilisez Option. La liste signale les agents qui vous attendent, comme l’explique Notifications.