O que é um workspace remoto no Tallos?
Um workspace remoto é um workspace do Tallos cujos arquivos, worktree do git, terminais e agentes ficam num host remoto conectado via SSH. Você escolhe o host ao criar o workspace; o resto funciona como um workspace paralelo local.
Use quando o notebook não é o lugar certo para o trabalho: builds longos, suítes de teste grandes, uma máquina com GPU, o desktop mais forte do escritório ou uma VM na nuvem que já tem seu repositório, ferramentas e credenciais. Rodar vários agentes ao mesmo tempo pesa, e um host remoto deixa você rodar mais agentes em paralelo sem o cooler do notebook disparar.
| Parte | Roda no host remoto | Aparece no seu computador |
|---|---|---|
| Worktree do git, branches, commits | Sim | Status, diffs e ações de commit |
| CLIs dos agentes e seus logins | Sim | Chat e terminal, estado do agente ao vivo |
| Terminais e servidores de dev | Sim | Abas, splits e histórico |
| Editor | Os arquivos são salvos no host | A edição acontece no Tallos |
| Portas | Seu servidor escuta lá | Encaminhadas para a sua máquina |
Como adiciono um host SSH no Tallos?
- 1
Abra Configurações → SSH
Clique em Adicionar Alvo. O formulário do host abre numa janela de diálogo.
- 2
Preencha ou importe o host
Informe host ou alias, usuário, porta e, se quiser, um arquivo de identidade (por padrão usa o SSH agent). Ou abra o seletor de config do OpenSSH, busque no
~/.ssh/config, incluindo arquivos deInclude, e preencha o formulário a partir de um host. - 3
Desbloqueie a chave
Se a chave tiver passphrase, o Tallos pergunta na primeira vez. A passphrase fica em memória durante a sessão.
- 4
Teste e salve
Clique em Testar para checar a conexão e depois em Salvar.
Como rodo um agente numa máquina remota?
- 1
Adicione o projeto
Adicione o repositório com o host SSH como local, ou abra qualquer pasta remota pelo seletor de arquivos. O git precisa estar instalado no host para workspaces de repositório.
- 2
Crie um workspace no host
Escolha o host em Executar em. O Tallos roda
git worktree addno remoto, então cada tarefa ganha branch e cópia de trabalho próprias lá. Nunca usou worktrees? Leia git worktrees para agentes de IA. - 3
Inicie o agente
Abra o Claude Code, o Codex ou qualquer outro agente. Ele roda no host remoto, então instale e faça login nele lá; os logins do seu notebook não vão junto.
- 4
Revise e entregue
Edite arquivos direto, leia o diff, faça commit e push pelo Tallos como sempre.
Tire o trabalho pesado do seu notebook
Adicione um host SSH, crie um workspace nele e rode seus agentes onde está o poder de processamento.
O que acontece quando a conexão cai?
Nada se perde. O agente continua rodando no host. Workspaces remotos mostram o status ao vivo (conectado, reconectando, desconectado) e, quando a conexão volta, o Tallos reconecta os terminais e reexibe a saída, inclusive interfaces de agente em tela cheia.
- Sobrevive ao fechar o app. As sessões de terminal remotas continuam rodando depois que você fecha o Tallos e voltam conectadas, com histórico, quando você reconecta.
- Sem contagem regressiva por padrão. Manter terminais ativos até redefinir vem ligado em todo host. Desligue para definir um tempo limite após a desconexão, de 60 segundos a 7 dias.
- Pare quando quiser. Encerre as sessões encerrando os terminais remotos, redefinindo o relay, removendo o host ou fechando a aba.
Como abro no navegador um servidor de dev remoto?
Use a aba Portas na barra lateral direita. O Tallos lista as portas em que seus processos remotos estão escutando, e um clique encaminha a porta para a sua máquina. Dá também para adicionar, editar ou remover encaminhamentos na mão. Eles sobrevivem a reinícios do app e reconexões, e portas privilegiadas do remoto são remapeadas localmente (a 80 remota vira a 10080 local).
O navegador integrado também funciona com workspaces remotos. Uma configuração define se o tráfego e o DNS dele passam pelo host SSH ou pelo seu computador.
Funciona com jump host, proxy e chave de segurança?
Funciona. Abra a Conexão Avançada do host para configurar.
| Necessidade | Como o Tallos resolve |
|---|---|
| Bastion ou jump host | Campo Jump Host, equivalente a ProxyJump / ssh -J |
| Túneis como o Cloudflare Access | Campo Proxy Command, por exemplo cloudflared access ssh --hostname %h |
| Setup mais rápido | Reutilizar conexão SSH para configuração mais rápida usa multiplexação do OpenSSH, ligada por padrão |
| Kerberos / GSSAPI | Hosts com GSSAPIAuthentication yes conectam pelo OpenSSH do sistema |
| Chaves de segurança FIDO2 | Chaves ed25519-sk e ecdsa-sk usam o OpenSSH do sistema, então toque e PIN funcionam |
| Abrir no VS Code | Abrir em → VS Code inicia o Remote-SSH no mesmo host e caminho |
Também dá para baixar um arquivo remoto, ou uma pasta inteira quando a conexão suporta SFTP, com o botão direito no explorador de arquivos. Automações agendadas também podem rodar em hosts SSH.
Do que a máquina remota precisa?
- Acesso SSH com chave, SSH agent, chave de segurança ou Kerberos.
- Git, para workspaces de repositório.
- As CLIs dos seus agentes, instaladas e com login feito no host.
- Ferramentas de build em alguns hosts. Na primeira conexão, o Tallos instala um pequeno relay no remoto. Se o host precisar compilá-lo e não tiver
make, um compilador C++ epython3, arquivos, git e editor funcionam, mas os terminais remotos só funcionam depois que você instalar essas ferramentas e reconectar.
O Tallos não vende nem hospeda máquinas remotas. Workspaces remotos sempre usam hosts que você controla, e seus agentes continuam usando as assinaturas e chaves de API que você já tem. Os terminais se comportam igual ao terminal do Tallos local.
Perguntas frequentes
Consigo rodar o Claude Code ou o Codex num servidor remoto com o Tallos?
Consegue. Adicione o servidor em Configurações → SSH, crie um workspace escolhendo esse host em Executar em e inicie o agente. Ele roda no servidor enquanto você acompanha e revisa no Tallos.
Os agentes remotos param se o notebook dormir?
Não. O agente segue rodando no host. Quando a conexão volta, o Tallos reconecta o terminal e reexibe a saída.
Os terminais remotos sobrevivem quando fecho o Tallos?
Sobrevivem. As sessões remotas continuam rodando depois que você fecha o app e voltam conectadas, com histórico. Por padrão ficam ativas até você encerrar; dá para definir um tempo limite de 60 segundos a 7 dias.
O Tallos usa minha configuração de SSH atual?
Usa. O seletor de config do OpenSSH busca no ~/.ssh/config, incluindo os arquivos incluídos, e preenche o host. Jump hosts e proxy commands são suportados.
Como vejo um app web que está rodando no host remoto?
Abra a aba Portas e encaminhe a porta com um clique, depois abra no navegador integrado ou no seu navegador. Os encaminhamentos persistem entre reinícios e reconexões.
O Tallos fornece a máquina remota?
Não. O Tallos se conecta via SSH a máquinas que você já controla. Ele não vende hospedagem, e seus agentes usam suas próprias assinaturas ou chaves de API.
Preciso instalar meus agentes no host remoto?
Precisa. Os agentes rodam no host, então instale e faça login em cada CLI de agente lá. Os logins do seu notebook não vão junto.