Todas as páginas
  1. Primeiros passos
  2. Conectar máquinas
  3. Pastas: o que o prédio vê
  4. Visões
  5. Conversar com as sessões
  6. Aprovações e avisos
  7. Ferramentas do dia a dia
  8. Times de agentes
  9. Código e Git
  10. Prévia no celular
  11. No celular
  12. Uso do plano
  13. Codex
  14. Antigravity
  15. GitHub Copilot
  16. Prédios, pessoas e papéis
  17. Central de comando
  18. Enterprise: política, SSO e relatórios
  19. Sua conta
  20. Assinatura
  21. Atalhos de teclado
  22. Solução de problemas
Documentação

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

No Mac: baixar, arrastar para Aplicativos, abrir e entrar com a sua conta (23 s).
No Windows: baixar, os avisos do Edge e do Windows, instalar e entrar com a sua conta (45 s).
Depois: instalar e entrar no Claude Code e no Codex pela tela Ligue um agente, sem terminal (56 s).

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> --hook

No Windows, cole no PowerShell (sem ser administrador):

& ([scriptblock]::Create((irm https://ai.fleetly.tools/install.ps1))) -Token <token> -Hook

O 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 sudo para 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 LinuxWindows
Claude Codecurl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iex
Codexnpm install -g @openai/codexnpm install -g @openai/codex ou a extensão do Codex no VS Code
Antigravitycurl -fsSL https://antigravity.google/cli/install.sh | bashveja antigravity.google/cli
GitHub Copilotnpm install -g @github/copilotnpm install -g @github/copilot
gitMac: 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 diagnostico

Linux: 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 LinuxWindowsPara quê
--hook-HookGrava os hooks do Claude Code e do Codex, para aprovar pelo painel e aplicar as regras do prédio.
--pastas ~/trabalho,~/outra-PastasO prédio vê só as sessões dessas pastas. Veja Pastas.
--hook-port 4747-HookPortPorta local dos hooks. Troque se a 4747 já estiver em uso.
--dry-run-DryRunMostra o que seria feito, sem gravar nada.
--trocar-TrocarConfirma a troca de prédio sem perguntar, quando a máquina já está ligada a outro prédio (veja abaixo).
--adicionar-AdicionarLiga 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-PastasAtualCom --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 ~/cliente

Para 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.

  1. 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.
  2. 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.
  3. Entrar no Antigravity: a página do Google abre sozinha; autorize com a sua conta e cole no painel o código que aparecer.
  4. Entrar no Copilot: a página do GitHub abre sozinha, com o código já copiado: é só colar.
  5. 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

SistemaLog do coletor
Mactail -f ~/Library/Logs/fleetly-coletor.log
Linuxjournalctl -u fleetly-coletor -f
Linux sem systemd (contêiner, Codespaces)tail -f ~/.fleetly/collector/coletor.log
WindowsGet-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

  1. 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.
  2. Na máquina, remova o serviço:
node ~/.fleetly/collector/fleetly-collector.mjs uninstall

No Windows, no PowerShell:

node "$env:USERPROFILE\.fleetly\collector\fleetly-collector.mjs" uninstall

Se 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.