Conectar máquinas
Cada máquina roda um coletor, ligado à central por uma conexão de saída. Não é preciso abrir porta, ter IP público nem configurar túnel: funciona atrás de firewall e NAT.
O que a máquina precisa
- macOS, Linux ou Windows.
- Pelo menos um agente, o Claude Code, o Codex, o Antigravity ou o GitHub Copilot, instalado e logado no usuário que vai rodar o coletor. Sem ele, o coletor mostra as sessões, mas não consegue responder por elas. Se faltar, o instalador oferece instalar (veja Máquina sem nada instalado).
- Node 20 ou mais novo. Se não houver, o instalador baixa um Node só para o coletor, conferido pelo SHA-256 oficial (não vale para o Alpine Linux). O app do Mac e do Windows não precisa de Node.
- O git, para a aba Código (commit e push) e os times. No Windows, o Claude Code precisa do Git for Windows.
- Rodar com o seu usuário, nunca como root nem como administrador.
Instalar
Em Configurações → Prédios → Máquinas → Adicionar máquina → Por comando, dê um nome à máquina, toque em Gerar comando e copie o comando, que já vem com o token dela. O token vale só para essa máquina e pode ser revogado ali mesmo.
No Mac e no Linux, cole no terminal:
curl -fsSL https://ai.fleetly.tools/install.sh | bash -s -- --token <token> --hookNo Windows, cole no PowerShell (sem ser administrador):
& ([scriptblock]::Create((irm https://ai.fleetly.tools/install.ps1))) -Token <token> -HookO instalador:
- baixa o coletor para
~/.fleetly/collector(no Windows,%USERPROFILE%\.fleetly\collector); - confere o Node, os agentes (Claude Code, Codex, Antigravity e GitHub Copilot), o git e se a central responde, e oferece instalar o que falta;
- guarda o token num arquivo que só o seu usuário lê;
- cria o serviço que liga o coletor sozinho: launchd no Mac, systemd no Linux (pede
sudopara gravar o serviço) e uma tarefa agendada no seu login no Windows; - com
--hook, pergunta se pode gravar os hooks de aprovação do Claude Code e do Codex, com backup dos arquivos (veja Aprovações).
Mac: se os seus projetos ficam em Documentos, Mesa ou Downloads, dê Acesso Total ao Disco ao Node que o instalador mostrar (Ajustes do Sistema → Privacidade e Segurança → Acesso Total ao Disco). Sem isso, o serviço não consegue ler essas pastas.
Máquina sem nada instalado
O instalador e o app mostram o que a máquina tem e o que falta, com o comando oficial de cada um para o sistema. No terminal, o instalador pergunta se pode instalar cada agente que falta (e o git no Mac e no Windows); no app, use Instalar em Agentes neste computador.
| Mac e Linux | Windows | |
|---|---|---|
| Claude Code | curl -fsSL https://claude.ai/install.sh | bash | irm https://claude.ai/install.ps1 | iex |
| Codex | npm install -g @openai/codex | npm install -g @openai/codex ou a extensão do Codex no VS Code |
| Antigravity | curl -fsSL https://antigravity.google/cli/install.sh | bash | veja antigravity.google/cli |
| GitHub Copilot | npm install -g @github/copilot | npm install -g @github/copilot |
| git | Mac: xcode-select --install. Linux: o gerenciador de pacotes (sudo apt install git) | winget install --id Git.Git |
Depois de instalar, entre em cada agente pelo painel: na tela Ligue um agente ou em Configurações → Prédios → Máquinas → Contas desta máquina (útil numa máquina que você não tem à frente), para o Claude Code, o Codex, o Antigravity e o GitHub Copilot. O Copilot também usa o gh auth login que a máquina já tiver.
Para ver de novo o que falta, a qualquer hora:
node ~/.fleetly/collector/fleetly-collector.mjs diagnosticoLinux: o Ubuntu Desktop vem sem o curl. Antes do comando, rode sudo apt install -y curl. O GitHub CLI (gh), o VS Code e o Python aparecem como opcionais: servem para o pull request pelo painel, para conversar com as sessões abertas no VS Code e para o % do plano do Claude sem a status line.
Opções do comando
| Mac e Linux | Windows | Para quê |
|---|---|---|
--hook | -Hook | Grava os hooks do Claude Code e do Codex, para aprovar pelo painel e aplicar as regras do prédio. |
--pastas ~/trabalho,~/outra | -Pastas | O prédio vê só as sessões dessas pastas. Veja Pastas. |
--hook-port 4747 | -HookPort | Porta local dos hooks. Troque se a 4747 já estiver em uso. |
--dry-run | -DryRun | Mostra o que seria feito, sem gravar nada. |
--trocar | -Trocar | Confirma a troca de prédio sem perguntar, quando a máquina já está ligada a outro prédio (veja abaixo). |
--adicionar | -Adicionar | Liga a máquina também a este prédio, sem sair do outro. Precisa de --pastas com as pastas deste prédio (veja abaixo). |
--pastas-atual ~/pessoal | -PastasAtual | Com --adicionar, as pastas que o prédio de antes continua vendo, se ele via a máquina inteira. |
Uma máquina, um prédio
Cada máquina conecta a um prédio, a não ser que você a adicione a mais de um (veja Mais de um prédio no mesmo computador). Se você rodar nela o comando de outro prédio (com outra conta, por exemplo), o instalador avisa de onde para onde e pergunta se é para trocar ou adicionar. Fora de um terminal, a troca só acontece com --trocar. Pelo app, a página de Conectar mostra de qual prédio a máquina sai e em qual entra, e só troca depois de você marcar Entendi e tocar em Trocar de prédio.
- Depois da troca, o prédio de antes vê a máquina como Mudou de prédio (sem saber para qual), o token dela de lá é revogado e o dono é avisado no celular. Tudo fica na auditoria dos dois prédios.
- Reinstalar no mesmo prédio, com um token novo, não pergunta nada: o token antigo é revogado e a máquina antiga aparece como Reinstalada.
- No Enterprise, o dono pode travar uma máquina só (Travar esta máquina, tocando nela em Configurações → Prédios → Máquinas) ou todas (Travar as máquinas, em Configurações → Prédios → Segurança): aí a troca é recusada até ele destravar ou revogar a máquina no prédio dele, e cada tentativa chega no celular dele.
Mais de um prédio no mesmo computador
Para quem trabalha para mais de um prédio no mesmo usuário do computador, como a sua empresa e um cliente. Cada prédio vê só as pastas dele, e nenhuma pasta é de dois.
No app do Fleetly: em Configurar… → O que o prédio vê, toque em Adicionar outro prédio…. Escolha as pastas do novo prédio (e as do prédio de agora, se ele via o computador inteiro) e toque em Entrar com a conta do novo prédio. O menu passa a mostrar uma linha por prédio, e Sair de um prédio tira só aquele.
No terminal: rode o comando do outro prédio com --adicionar e as pastas dele:
curl -fsSL https://ai.fleetly.tools/install.sh | bash -s -- --token <token> --adicionar --pastas ~/clientePara conferir os prédios da máquina, fleetly-collector ligacoes. Para mudar as pastas de um deles, fleetly-collector pastas --predio <id> add <pasta>. Para sair de um só, fleetly-collector sair --predio <id>.
- Cada prédio vê as sessões, o git, as aprovações, as prévias, a busca e o relatório só das pastas dele. Um pedido de aprovação vai só para o prédio dono da pasta, e só a política desse prédio vale ali.
- Cada prédio tem o seu modo de aprovação (Automático, Sempre aqui ou Só no computador). No menu do app, há um Aprovar em … por prédio; no terminal,
fleetly-collector aprovacao --predio <id> on. - Os dois prédios veem o mesmo nome do computador, o sistema, as versões do Claude e do Codex e o uso do plano, que é seu e não de uma pasta.
- O dono de cada prédio vê, em Configurações → Prédios → Máquinas, que a máquina também está ligada a outro prédio, sem saber qual.
- No Enterprise com a máquina travada (Travar esta máquina ou Travar as máquinas), ela é só daquele prédio: a ligação a outro é recusada, inclusive se a trava vier depois, e o dono recebe o aviso.
- Um agente que você conduz por um prédio roda com o seu usuário e enxerga o disco como sempre. As pastas limitam o que o Fleetly mostra e alcança, não o que o agente consegue ler.
Atualizações
O app do Fleetly procura versão nova na central um minuto depois de abrir e a cada 6 horas. Quando há, o menu mostra Instalar a versão …: um clique baixa, confere a assinatura do pacote e reinicia o app já atualizado (o coletor dentro dele vem junto). Quem tem a versão 0.1.0 instala a 0.1.1 uma vez pelo download; dali em diante, é pelo menu.
O coletor confere a versão da central um minuto depois de ligar e a cada 30 minutos, tanto o instalado pelo comando quanto o de dentro do app. Quando há versão nova, ele baixa, confere a assinatura de quem publica o Fleetly e o SHA-256 de cada arquivo e reinicia quando nenhuma resposta está em andamento. Não é preciso fazer nada: no app, a atualização do coletor não espera uma versão nova do app. Se a versão nova não ficar de pé, o app volta para o coletor que veio com ele.
Entrar nas contas de longe
Numa máquina que você não tem à frente (um servidor, um GitHub Codespace), dá para entrar no Claude, no Codex, no Antigravity, no Copilot e no GitHub pelo painel. Em Configurações → Prédios → Máquinas, toque na máquina e em Contas desta máquina: aparecem as contas, com Conectado, Sem login ou Não instalado (e Instalar).
Quando o agente pede um login que ele não consegue fazer (por exemplo, “rode gcloud auth login no terminal”): na máquina que tem o Google Cloud SDK, Contas desta máquina mostra também Google Cloud (a sua conta) e Google Cloud (credencial de aplicativo), a que as bibliotecas do Google usam. Toque em Entrar, autorize na página do Google, copie o código que ela mostra no fim e cole no painel. Na conversa, quando a última resposta do agente traz o comando (gcloud auth login, gcloud auth application-default login ou gh auth login), aparece o botão Entrar ali mesmo; conectado, diga ao agente para continuar. A senha e o código ficam entre você, o Google e a máquina.
- Entrar no Claude: a página do login abre sozinha; autorize com a sua conta e cole no painel o código que aparecer. A máquina guarda um token de longa duração, só nela.
- Entrar no Codex: a página do login abre sozinha e o código já vai copiado: é só colar. Se o ChatGPT pedir, ative antes o login com código de dispositivo nas configurações de segurança do ChatGPT.
- Entrar no Antigravity: a página do Google abre sozinha; autorize com a sua conta e cole no painel o código que aparecer.
- Entrar no Copilot: a página do GitHub abre sozinha, com o código já copiado: é só colar.
- Entrar no GitHub: a página abre sozinha, com o código já copiado. Depois disso, o git da máquina clona e envia os seus repositórios particulares.
Se o navegador bloquear a página, use Abrir o link. Só o dono do prédio entra e sai das contas. O código vale 15 minutos. A senha e os tokens nunca passam pela central: o login roda na própria máquina, com o programa oficial de cada um (claude setup-token, codex login --device-auth, gh auth login).
Ver o que está acontecendo
| Sistema | Log do coletor |
|---|---|
| Mac | tail -f ~/Library/Logs/fleetly-coletor.log |
| Linux | journalctl -u fleetly-coletor -f |
| Linux sem systemd (contêiner, Codespaces) | tail -f ~/.fleetly/collector/coletor.log |
| Windows | Get-Content $env:USERPROFILE\.fleetly\collector\coletor.log -Wait |
Num Linux sem systemd, o instalador deixa o coletor rodando em segundo plano, mas não o religa quando a máquina liga de novo. Ponha na partida da máquina (no Codespaces, no postStartCommand) o comando que o instalador mostra no fim: node ~/.fleetly/collector/fleetly-collector.mjs supervise.
Avisos do sistema
O app do Fleetly no Mac e no Windows avisa pelo sistema quando uma sessão termina e espera você (Sua vez), quando o coletor fica 5 minutos sem contato com a central e, no modo Sempre aqui, quando chega um pedido de permissão. No modo Automático, o pedido já aparece no VS Code ou no terminal, então não vira um segundo aviso. Para desligar, no menu do ícone, desmarque Avisos do sistema. A sessão aparece no próprio menu, para abrir no painel.
Remover uma máquina
- Em Configurações → Prédios → Máquinas, toque na máquina e use Revogar a máquina. O token deixa de valer na hora e a máquina sai do prédio.
- Na máquina, remova o serviço:
node ~/.fleetly/collector/fleetly-collector.mjs uninstallNo Windows, no PowerShell:
node "$env:USERPROFILE\.fleetly\collector\fleetly-collector.mjs" uninstallSe o instalador baixou o Node, troque node por ~/.fleetly/node/bin/node (no Windows, $env:USERPROFILE\.fleetly\node\node.exe). O token continua em ~/.claude/painel/collector-token: apague o arquivo se não for mais usar.
Pela própria máquina: no menu do app do Fleetly, use Sair do prédio…. O token é revogado na central e apagado do cofre de senhas do sistema. Com o coletor do comando, node ~/.fleetly/collector/fleetly-collector.mjs sair --central https://ai.fleetly.tools revoga o token e remove o serviço. Num prédio Enterprise com as máquinas travadas, só o dono tira a máquina.
Quantas máquinas
Cada máquina tem o próprio token, e revogar uma não afeta as outras. O plano Pessoal tem até 2 máquinas; o Team, 5 por pessoa paga; o Enterprise, sem limite. Veja os planos.
Não achou o que procurava? Escreva para admin@fleetly.tools.