Use o terminal no navegador
O terminal no navegador roda cada aba como uma sessão tmux no seu box. Feche o navegador e todas as abas continuam rodando. Cole prints, solte arquivos, clique em caminhos de arquivo e abra as páginas que o seu agente pede, tudo numa janela só.
Trabalhe com abas
- Escolha + ao lado das abas para abrir uma nova com o agente do box. Fora do terminal, aperte
T. - Dê um clique duplo numa aba para renomeá-la. Aperte
F2quando a aba estiver em foco. - Arraste uma aba para reordená-la, ou aperte
Alt+Shift+←eAlt+Shift+→. - Escolha o × de uma aba para fechá-la. Fechar encerra a sessão tmux e para todos os programas dentro dela, agentes inclusive.
- Escolha Tela cheia no canto direito da barra de abas.
A barra de abas mostra quantas abas você tem, por exemplo 3 de 10 abas. Um box comporta até 10. Feche uma para abrir outra.
Quando a conexão cai, o terminal mostra "Reconectando… o tmux segura a sessão" e volta sozinho. Se o shell de uma aba sair, escolha Iniciar um novo shell nesta aba.
Atalhos de teclado
O terminal responde como um terminal local. No Mac, o ⌘ é a tecla do terminal e nunca chega ao box, então Ctrl+C continua sendo uma interrupção e o Option funciona como Meta.
| Ação | Mac | Windows e Linux |
|---|---|---|
| Copiar a seleção | ⌘C | Ctrl+Shift+C ou Ctrl+Insert |
| Colar texto, imagens ou arquivos | ⌘V | Ctrl+Shift+V ou Shift+Insert |
| Colar como texto puro | ⌘⇧V | |
| Selecionar tudo | ⌘A | Ctrl+Shift+A |
| Limpar a tela e o histórico | ⌘K | |
| Buscar no histórico | ⌘F | Ctrl+Shift+F |
| Ditar | ⌘⇧Space | Ctrl+Shift+Space |
| Texto maior, menor, padrão | ⌘+, ⌘−, ⌘0 | |
| Abrir um link ou caminho de arquivo | ⌘-clique | Ctrl-clique |
| Selecionar texto quando o tmux controla o mouse | Arrastar com Option | Arrastar com Shift |
No Windows e no Linux, o Ctrl+V simples cola uma imagem. Qualquer outra coisa vai para o shell como ^V.
Clique com o botão direito no terminal para um menu com copiar, colar, selecionar tudo, limpar e buscar. Aperte ? em qualquer lugar do painel para ver a lista completa de atalhos.
Copie texto de dentro do box
Selecione o texto e copie como de costume. Os programas dentro do box também podem preencher a sua área de transferência. O xclip e o wl-copy mandam o texto para o seu navegador, e o modo de cópia do tmux faz o mesmo. O painel confirma com "O box mandou um texto para copiar." É assim que um código de uso único do gh auth login cai na sua área de transferência.
Cole prints no agente
Cole uma imagem com ⌘V ou Ctrl+V. A imagem sobe para ~/.cache/detachbox/clipboard/ no box, e o caminho dela é colado na aba. O Claude Code, o Codex, o Gemini CLI e o OpenCode transformam esse caminho num anexo de imagem. As imagens vão até 20 MB.
Solte arquivos no box
Arraste arquivos do seu computador para o terminal.
- Imagens de até 20 MB e outros arquivos de até 50 MB.
- Os arquivos vão para
~/uploads/com os nomes originais, e os caminhos são colados na aba. - Um upload por vez. Aperte
Escpara cancelar. - Pastas são recusadas. Compacte a pasta num zip antes, ou copie com
rsyncpor SSH.
Busque no histórico
Aperte ⌘F ou Ctrl+Shift+F. Digite para buscar, passe pelos resultados com os botões de seta e aperte Esc para fechar.
Abra links e caminhos de arquivo
Links que começam com http abrem numa nova aba do navegador. Caminhos de arquivo na saída também são links. Dê ⌘-clique ou Ctrl-clique neles, ou toque no celular. Um sufixo :line, como src/app.ts:42, pula para aquela linha.
Leia arquivos no visualizador
Um caminho de arquivo abre no visualizador, por cima do terminal. Ele mostra:
- código-fonte com números de linha e destaque de sintaxe
- markdown renderizado
- imagens e PDFs
- CSV como tabela
- logs longos a partir do fim, com Carregar linhas anteriores para ler para trás
O visualizador mostra arquivos de até 20 MB. Baixar aceita arquivos de até 1 GiB. O visualizador também tem estas ações:
- Copiar caminho copia o caminho absoluto.
- Compartilhar link cria um link que funciona sem login pelo tempo que você escolher. Veja Previews e arquivos.
- Abrir renderizado mostra um arquivo HTML como página no endereço de arquivos do box.
- Abrir no VS Code ou Abrir no Cursor abre o arquivo naquela linha pelo Remote-SSH, com a sua própria chave SSH. No celular, esse botão não aparece.
Para abrir qualquer arquivo pelo caminho, aperte ⌘K ou Ctrl+K e escolha Abrir um arquivo em seguido do nome do box. Digite um caminho absoluto, um caminho a partir da sua home (~/…) ou um relativo à aba.
Trate as páginas que o agente abre
Quando um agente roda detachbox-open, xdg-open ou $BROWSER, o painel mostra "O agente abre uma página:" com o host. Escolha Abrir.
Deixe Abrir automaticamente daqui em diante marcado, e as próximas páginas abrem sozinhas. Mude isso depois em Configurações → Páginas que o agente abre. A escolha vale por navegador. Se o navegador bloquear o pop-up, permita pop-ups para my.detachbox.com.
Um link para o localhost:<port> do próprio box abre como a URL de preview do box.
Escolha um tema e o tamanho do texto
O painel segue Sistema, Claro ou Escuro, definido em Configurações → Aparência. Os agentes desenham as telas para um terminal escuro, então O terminal fica escuro vem ligado por padrão. Desligue para ter um terminal claro no tema claro.
O tamanho do texto muda com ⌘+ e ⌘− no Mac, ou pelo menu de comandos do ⌘K. No celular, faça pinça com dois dedos.
Acompanhe todas as abas de uma vez
Aperte Ctrl+` (a tecla de crase) para mostrar ou esconder a lista de terminais ao lado de qualquer página. Alt+1 a Alt+9 pulam para um terminal da lista. No Mac, use o Option. A lista marca os agentes que precisam de você, como explica Notificações.