- Ferramenta que permite que agentes de codificação por IA criem e controlem sandboxes em nuvem diretamente pela linha de comando, iniciando automaticamente VMs e instâncias com GPU
- Cria ambientes remotos de desenvolvimento a partir de diretórios locais ou repositórios Git, com suporte a várias formas de acesso, como VS Code, Jupyter, VNC e terminal
- Com a integração com Chrome CDP, é possível executar pela CLI automações como navegação no navegador, preenchimento, cliques, capturas de tela e scraping de dados
- Oferece controle detalhado de recursos, incluindo upload/download e sincronização automática de arquivos, seleção de GPU (como
--gpu H100:2) e dimensionamento (como --size small)
- Open source (MIT). Disponível para macOS, Linux e Windows
Visão geral
- O cloudrouter é uma skill baseada em CLI que permite que agentes de codificação por IA como Claude Code, Codex e Cursor criem e gerenciem sandboxes de VM e GPU na nuvem
- É possível criar sandboxes pela linha de comando, executar comandos, transferir arquivos e até automatizar o navegador
- Pode ser instalado com o comando
npx skills add manaflow-ai/cloudrouter
Instalação e autenticação
- Pode ser adicionado como skill para agentes de IA ou instalado como CLI independente
- Após
npm install -g @manaflow-ai/cloudrouter, autentique-se com cloudrouter login
- Tanto os comandos
cloudrouter quanto cr podem ser usados
Principais recursos
- Sandboxes em nuvem prontas para uso imediato: cria VMs remotas a partir de diretórios locais, repositórios Git ou templates
- Inclui suporte a Docker e sincronização automática de arquivos
- Integração com agentes de IA: permite criar sandboxes, executar código e automatizar o navegador diretamente no Claude Code, Cursor e afins
- Automação de navegador: com base em Chrome CDP, permite navegar, clicar, preencher, tirar screenshots e analisar a árvore de acessibilidade
- Múltiplas formas de acesso: oferece suporte a navegador do VS Code, desktop VNC, terminal e execução de comandos isolados
- Transferência de arquivos: fornece upload/download e reenvio automático ao detectar alterações
- Open source: licença MIT, escrito em Go, distribuído como pacote npm para macOS, Linux e Windows
Opções de GPU e instância
- Sandboxes padrão ficam disponíveis imediatamente, e instâncias com GPU podem ser adicionadas com a opção
--gpu
- Exemplo:
--gpu H100:2 usa 2 GPUs H100
- Tipos de GPU e usos
- T4 (16GB) : inferência e fine-tuning de modelos pequenos
- L4 (24GB) : geração de imagens
- A10G (24GB) : treinamento de modelos médios
- L40S (48GB) : geração de vídeo
- A100 (40GB) : treinamento de modelos grandes (7B–70B)
- H100 (80GB) , H200 (141GB) , B200 (192GB) : para pesquisa de alto desempenho e modelos de fronteira
Automação de navegador
- Cada sandbox inclui um navegador integrado com Chrome CDP
- É possível abrir URLs, capturar snapshots da árvore de acessibilidade, interagir com elementos e tirar screenshots
- Exemplo:
cloudrouter browser open cr_abc123 "https://example.com"cloudrouter browser fill cr_abc123 @e1 "user@example.com"cloudrouter browser click cr_abc123 @e3
Gerenciamento de sandbox
- Fornece comandos de gerenciamento para listar sandboxes em execução, verificar status, parar e excluir
cloudrouter ls, cloudrouter stop , cloudrouter delete
- Suporta pausa (
stop) e retomada (resume), além de extensão de timeout (extend)
- Existe um limite máximo de 10 sandboxes executando simultaneamente
Transferência e sincronização de arquivos
- Suporta transferência bidirecional de arquivos entre o ambiente local e a sandbox
- Upload:
cloudrouter upload ./src
- Download:
cloudrouter download ./dist
- É possível configurar upload automático por detecção de mudanças (
--watch) e padrões de exclusão (-e "*.log")
Acesso ao ambiente de desenvolvimento
- Oferece várias interfaces remotas de desenvolvimento
- VS Code:
cloudrouter code
- Jupyter Lab:
cloudrouter jupyter
- Desktop VNC:
cloudrouter vnc
- Sessão de terminal:
cloudrouter pty
Diretrizes de segurança
- A URL de port forwarding do E2B fica pública sem autenticação, portanto nunca deve ser compartilhada
- Em vez disso, apenas as URLs de VNC, VS Code e Jupyter podem ser compartilhadas com segurança
- O acesso ao servidor de desenvolvimento deve ser feito por
cloudrouter vnc
Guia de solução de problemas
- Em caso de erro no
npm install: o comando sudo chown -R 1000:1000 /home/user/.npm é obrigatório
- Em caso de falha no comando
ssh: é preciso colocar o comando inteiro entre aspas
- Em caso de falha em comandos de navegador: é necessário aguardar um pouco após criar a sandbox
- Também são indicados erros frequentes, como ordem incorreta do flag
snapshot e uso indevido do flag extend
Open source e suporte
- Disponibilizado sob a licença MIT, com código no GitHub
- Suporte a macOS, Linux e Windows
- Canais oficiais: GitHub, Twitter, Discord
1 comentários
Comentários do Hacker News
cloudrouter start .e apareceu uma solicitação de senha para autenticação no servidorEntão abri uma issue
Quando várias funções são forçadas dentro de uma única ferramenta, fica mais difícil corrigir ou expandir, e a flexibilidade também cai
Eu prefiro ferramentas pequenas, em componentes e fracamente acopladas. Assim fica mais fácil para o usuário modificar ou combinar por conta própria
Os templates Docker agrupam vários apps em um único contêiner, o que aumenta o custo de build, suporte e compatibilidade
É melhor manter cada app em um contêiner separado e conectá-los via TCP, sockets ou volumes
Além disso, ver lógica de navegador misturada no código de autenticação é um sinal de baixa coesão
E também notei no código de rsync uma parte que desativa a verificação da chave de host SSH, o que é um risco de segurança grande
Escolhi uma estrutura monolítica para priorizar início rápido e simplicidade, mas isso reduz a liberdade de configuração
No caso dos templates Docker, o objetivo é que o agente envie o diretório de trabalho e já suba o ambiente de desenvolvimento imediatamente
Separar em vários contêineres aumenta a complexidade com montagens, rede e afins
O SSH não se conecta diretamente ao host real; ele é tunelado por TLS WebSocket
Como usa token de autenticação por sessão e chaves temporárias de VM, a porta SSH não fica exposta externamente
Recentemente adicionamos recursos de suporte a agentes
Estamos focando em orquestração de contêineres que vai do desenvolvimento ao treinamento e à inferência
Sem a chatice de configurar conta de nuvem, grupos de segurança ou gerenciar chaves SSH
O cloudrouter já vem com Docker/VNC/Jupyter Lab incluídos, então não é preciso se preocupar com a configuração do ambiente