TowerCTL Baixar

Documentação

Problemas comuns

As situações que mais aparecem e o que fazer em cada uma. Se a sua não estiver aqui, veja como relatar um problema.

O Windows bloqueou o instalador#

A tela “O Windows protegeu o computador” aparece porque esta versão de teste ainda não tem certificado de assinatura digital. Clique em Mais informações e depois em Executar assim mesmo.

O Mac não abre o app (“abrir mesmo assim”)#

O TowerCTL ainda não tem a assinatura da Apple, então na primeira vez o Mac diz que não consegue verificar o app, ou que ele vem de um desenvolvedor não identificado. O app não está danificado.

  1. Na pasta Aplicativos, clique com o botão direito (ou Control e clique) no TowerCTL e escolha Abrir. Confirme em Abrir.
  2. Se a janela só tiver OK, abra Ajustes do Sistema › Privacidade e Segurança, role até a mensagem sobre o TowerCTL e clique em Abrir mesmo assim.

Só é preciso fazer isso uma vez por versão instalada. Quando sai uma versão nova, o app avisa e abre a página de download: você baixa o novo .dmg e repete esse passo na primeira abertura.

O app não encontra o claude no Mac ou no Linux#

O app procura claude, codex, gemini e o git no PATH do seu shell de login (o zsh ou bash que você usa no Terminal). Se ele diz que falta algo que você já instalou:

  1. Abra o Terminal e rode which claude. Se não aparecer um caminho, o programa não está instalado para o seu usuário: use o botão Instalar do app.
  2. Se aparecer um caminho, ele tem de estar no PATH também para quem abre o app pelo Dock ou pelo menu de aplicativos. Ponha o export PATH=… no arquivo certo do seu shell (~/.zprofile ou ~/.zshrc no Mac, ~/.profile ou ~/.bashrc no Linux).
  3. Feche o TowerCTL por completo (⌘Q no Mac) e abra de novo: o app lê o PATH uma vez, ao abrir. Depois, clique em Verificar de novo na tela de boas-vindas.

O Claude Code instalado pelo instalador oficial fica em ~/.local/bin, que o app já procura. Os CLIs do npm (como o Codex e o Gemini) precisam do Node.js e ficam na pasta global do npm. Se o npm reclamar de permissão (EACCES), o painel de instalação mostra o guia do npm para resolver.

O Linux diz que não guarda as senhas (chaveiro)#

As senhas do projeto e as chaves de API ficam cifradas pelo chaveiro do sistema. No Linux isso exige o GNOME Keyring (pacote gnome-keyring, comum em Ubuntu, Fedora e outros desktops GNOME) ou o KWallet (KDE), ativo na sua sessão. Sem um deles, o app recusa salvar com a mensagem “Este Linux não tem um chaveiro do sistema (GNOME Keyring/KWallet) disponível”, e nada é gravado em texto aberto.

O Mac pede a senha do Chaveiro (Keychain)#

O TowerCTL usa o Chaveiro do Mac para cifrar as senhas do projeto e para guardar uma cópia do controle do teste grátis. O Mac pode perguntar se o app pode usar o chaveiro, pedindo a senha de login do Mac. É a senha do seu usuário, e ela fica só no seu computador. Escolha Sempre Permitir para não ser perguntado de novo. Se você escolher Negar, as senhas do projeto não são salvas, mas o resto do app funciona.

O app diz que falta o Claude Code ou o git#

Na tela Bem-vindo ao TowerCTL, clique em Instalar ao lado do que faltar. Uma janela de terminal (o PowerShell no Windows, o Terminal no Mac, o terminal do sistema no Linux) roda o instalador oficial. Quando ela terminar, volte ao app e clique em Verificar de novo.

Se a janela mostrar um erro, copie a mensagem e mande junto com o relato (veja o fim desta página).

Uma IA diz que não está instalada#

Ao abrir uma IA em + Outra IA que não está no computador, o app pergunta se você quer abrir o instalador oficial. Aceite, espere a janela do instalador terminar e abra a IA de novo. O Gemini precisa do Node.js instalado antes.

A seção Suas IAs, nas Configurações, mostra o que está instalado e tem um botão Instalar para cada IA que falta.

O painel pede para entrar na conta#

Na primeira vez, cada IA pede login com a sua conta: o Claude Code abre o navegador, e o Codex mostra “Sign in with ChatGPT”. Enquanto isso, o painel fica em precisa de você. Clique no painel e siga as instruções que aparecem nele.

O Gemini pede login mesmo que você já use o Gemini neste computador, porque no TowerCTL ele tem uma pasta de configuração própria.

O painel pergunta se confio na pasta#

É o Claude Code perguntando “Do you trust this folder?” numa pasta nova. Clique no painel, escolha Yes, I trust this folder com as setas e aperte Enter. Nas cópias isoladas dos ajudantes, o app responde sozinho.

O limite de uso acabou#

O painel mostra ⏸ limite · volta às e a hora. Com Retomar sozinho quando renovar ligado, o agente volta sozinho quando o limite renova, desde que o app esteja aberto. Para trabalhar antes disso, abra um painel com outra IA em + Outra IA. Veja Limite de uso e fila.

Um agente está em “precisa de você” e não sai#

  1. Procure o painel: a bolinha do projeto, na lista da esquerda, e a da aba da missão mostram onde há um agente esperando.
  2. Leia o fim do painel. Normalmente é uma pergunta, um pedido de permissão ou um login.
  3. Clique dentro do painel e responda ali. Nas listas de opções, use as setas e Enter.
  4. Se o painel não responde, use ↻ para reiniciar. A conversa é retomada.

No modo Perguntar antes, o pedido pode ser para abrir um ajudante: a janela Abrir um ajudante? fica na frente dos painéis.

Ctrl+R e outros atalhos do terminal#

No Mac, leia ⌘ onde esta documentação diz Ctrl nos atalhos do app; o ⌃ (Control) é do terminal.

O app não tem menu de janela, então Ctrl+R não recarrega mais a janela: a tecla vai para o programa do painel, como num terminal comum. Só as combinações da página Atalhos ficam com o app.

Se letras acentuadas aparecerem trocadas num painel, troque para outra janela e volte: o app redesenha os terminais quando a janela volta ao foco.

A revisão diz que a pasta não usa git#

Sem git não dá para ver diferenças, voltar no tempo nem dar cópias isoladas aos ajudantes. Peça a um agente: “inicialize o git nesta pasta e faça o primeiro commit”. Veja Projetos sem git.

Publicar na Vercel não funciona#

O relatório mostra 0 tarefas concluídas#

O relatório conta só as tarefas escritas como lista de verificação em tarefas.md, com - [x]. Peça ao líder para manter as tarefas nesse formato. Veja Relatório para o cliente.

O medidor de uso está vazio ou apagado#

Abri o app duas vezes#

O TowerCTL roda uma janela só. Se você tentar abrir outra, ele traz para a frente a que já está aberta.

Onde ficam os seus dados#

Tudo fica no seu computador.

Dados do app
No Windows, %APPDATA%\towerctl, ou seja, C:\Users\seu-usuario\AppData\Roaming\towerctl. No Mac, ~/Library/Application Support/towerctl. No Linux, ~/.config/towerctl. Ali ficam as configurações, a lista de projetos, missões e painéis, as senhas cifradas, os seus squads, as medidas de uso, a licença, as configurações das outras IAs (como o login do Gemini) e a Vercel instalada pelo app.
Em cada projeto
A pasta .towerctl, com a memória (memoria), as cópias dos ajudantes (worktrees) e os relatórios (relatorios). Ela fica fora do git e da publicação.
Conversas
Cada IA guarda as próprias conversas. As do Claude Code ficam na pasta dele, em .claude, dentro da sua pasta de usuário.

Como relatar um problema#

  1. Anote o que você fez, o que esperava e o que aconteceu.
  2. Tire um print da tela com Win+Shift+S no Windows, ⇧⌘4 no Mac ou a tecla PrtSc no Linux.
  3. Durante o teste interno, mande para o André.

No botão do canto inferior esquerdo, o que mostra o teste ou a licença, existe a opção Enviar relatórios de erro anônimos. Nesta versão de teste ela ainda não envia nada, então o relato manual continua sendo o caminho.