O que eu preciso antes de instalar o Tallos no Mac?
Você precisa de um Mac com macOS 13 ou mais recente, com chip Apple Silicon ou Intel, e de uma conta no Tallos. O resto dá para configurar depois. O Tallos é um ambiente de desenvolvimento agêntico (ADE) para desktop: ele roda os agentes de IA que você já usa, cada um no seu workspace, então as CLIs dos agentes são programas à parte.
- macOS 13 ou mais recente. Confira em menu Apple → Sobre Este Mac.
- Uma conta no Tallos. O cadastro é gratuito e leva menos de um minuto em /signup.
- Git. Os workspaces do Tallos são git worktrees de verdade, então o git precisa estar instalado. Se
git --versionfalhar no Terminal, rodexcode-select --installpara instalar as ferramentas de linha de comando da Apple. - Pelo menos uma CLI de agente, como Claude Code, Codex ou Gemini CLI. Não é obrigatório na instalação: dá para instalar e entrar depois em Configurações → Conexões.
- Node.js ou Homebrew, se você quiser instalar agentes com um clique. O Tallos roda o comando oficial de cada fabricante, e esses comandos usam npm ou Homebrew.
Apple Silicon ou Intel: qual build do Tallos eu baixo?
Escolha o build que corresponde ao chip do seu Mac. Macs com chip da linha M usam o build Apple Silicon; Macs mais antigos com processador Intel usam o build Intel. O formulário de cadastro mostra as duas opções na hora de escolher o download.
| O que aparece em Sobre Este Mac | O que `uname -m` mostra no Terminal | Build certo |
|---|---|---|
| Chip: Apple M1, M2, M3 ou mais novo | arm64 | macOS · Apple Silicon |
| Processador: Intel Core i5, i7, i9… | x86_64 | macOS · Intel |
Como instalar o Tallos no macOS, passo a passo?
- 1
Crie sua conta no Tallos
Acesse /signup. Informe nome completo e e-mail de trabalho, depois sua função, o tamanho do time e os agentes que você já usa. No campo de download, escolha macOS · Apple Silicon ou macOS · Intel, aceite os termos e clique no botão para criar a conta e baixar.
- 2
Baixe o .dmg
A página de download abre com o seu build pronto. Se o build do seu sistema ainda não foi publicado, a conta é criada do mesmo jeito e o link chega por e-mail assim que ele sair.
- 3
Arraste o Tallos para Aplicativos
Dê dois cliques no .dmg para montá-lo e arraste o ícone do Tallos para a pasta Aplicativos. Quando a cópia terminar, ejete a imagem de disco.
- 4
Abra o Tallos e confirme o aviso do macOS
Abra o Tallos pela pasta Aplicativos ou pelo Spotlight. Como ele veio da internet, o macOS pede confirmação na primeira vez. Clique em Abrir. Os builds de release são assinados e notarizados, então essa checagem acontece uma vez só.
- 5
Escolha o idioma e o agente padrão
A tela de boas-vindas pede o idioma e mostra, em Qual agente de IA você usa?, as CLIs de agentes que o Tallos encontrou no Mac. Escolha uma e clique em Continuar. Nenhum agente encontrado? Continue mesmo assim e adicione depois em Configurações → Conexões.
- 6
Abra seu primeiro projeto
Clique em Escolher uma pasta e selecione a pasta com o seu código, ou use Clonar de uma URL para clonar um repositório. Também dá para clicar em Pular por agora e adicionar o projeto depois.
Baixe o build para macOS — crie sua conta e instale o Tallos.
O que acontece na primeira vez que eu abro o Tallos?
A primeira abertura é uma boas-vindas em dois passos. No primeiro, o Tallos se apresenta em uma frase, deixa você trocar o idioma da interface e pergunta qual agente de IA você usa. Ele procura as CLIs instaladas e mostra as que encontrou em cartões. No segundo, você abre seu primeiro projeto.
Depois das boas-vindas, três tours curtos aparecem sozinhos na hora certa: como começar uma tarefa, como testar um segundo agente na mesma tarefa e como revisar e decidir se fica ou descarta o resultado. Esse é o ciclo principal, e o guia da primeira tarefa mostra cada etapa.
O macOS também pode pedir permissão para o Tallos acessar pastas como Documentos, Mesa ou Downloads quando você abre um projeto guardado nelas. Permita: os agentes e o git precisam ler e gravar esses arquivos.
Por que o macOS pede confirmação antes de abrir o Tallos?
O macOS pede confirmação para todo app baixado da internet, mesmo os assinados. O Gatekeeper verifica se o app tem assinatura de um desenvolvedor identificado e se foi notarizado pela Apple, e pergunta uma vez. Os builds de release do Tallos saem assinados e notarizados, então basta clicar em Abrir. Se o macOS disser que não consegue verificar o desenvolvedor, abra Ajustes do Sistema → Privacidade e Segurança, desça até a seção Segurança e clique em Abrir Mesmo Assim para o Tallos, mas só para um arquivo baixado pela sua conta do Tallos.
Se o macOS disser que o app não pode ser aberto ou está danificado, não desative o Gatekeeper. Apague a cópia, baixe o build de novo pela sua conta e confira se escolheu o chip certo. Download incompleto ou app aberto direto do .dmg montado são as causas mais comuns.
Como adiciono agentes de IA depois de instalar o Tallos?
Abra Configurações → Conexões. Lá tem um cartão para cada CLI oficial de agente: Claude Code, Codex, Gemini CLI, OpenCode, Grok CLI, Qwen Code e MiMo Code. Cada cartão mostra se a ferramenta está instalada e conectada e oferece Instalar, Entrar e, quando o fabricante suporta, Usar chave de API.
No macOS, a instalação com um clique usa Homebrew ou npm, conforme o que cada fabricante documenta. Se aparecer Precisa do Homebrew primeiro ou Precisa do Node.js primeiro, instale a ferramenta e clique em Atualizar. O Tallos usa as assinaturas e chaves de API que você já tem; ele não revende acesso a modelos. Passo a passo completo: como conectar seus agentes.
Solução de problemas: e se o Tallos não instalar ou não abrir no Mac?
- “Este app não é compatível com este Mac.” Provavelmente você baixou o build errado ou o macOS é anterior ao 13. Confira o chip e a versão e baixe de novo.
- O Tallos abre, mas não encontra agentes. A CLI não está instalada ou não está no PATH que o Tallos enxerga. Instale em Configurações → Conexões, ou rode a CLI uma vez no Terminal para ver se funciona.
- A criação do workspace falha. Confira se a pasta é um repositório git e se o git está instalado. Se a branch base não foi buscada, rode
git fetch originno projeto e tente de novo. - Um agente não inicia. Rode o comando dele (por exemplo
claudeoucodex) num terminal. Se falhar lá também, o problema é de instalação ou login na própria CLI. - O comando `tallos` não é encontrado num terminal externo. Registre em Configurações → Geral → Tallos CLI e confira se
~/.local/binestá no PATH do seu shell. - O link de download não chegou. Se o seu build não estava publicado no cadastro, o link chega por e-mail quando ele sair. Veja o spam do e-mail usado no cadastro.
O que fazer depois de instalar o Tallos?
Rode uma tarefa real do começo ao fim: abra um projeto, comece uma tarefa num workspace próprio, acompanhe o agente e revise o diff. O guia da primeira tarefa leva uns dez minutos. Depois, teste rodar agentes em paralelo ou sua primeira squad.
Teste no seu próprio repositório.
Perguntas frequentes
O Tallos roda em Mac com Apple Silicon?
Sim. O Tallos tem um build nativo para Apple Silicon e outro separado para Intel. Escolha o do seu chip no formulário de cadastro.
Qual a versão mínima do macOS para o Tallos?
O Tallos precisa do macOS 13 ou mais recente, em Apple Silicon ou Intel.
Preciso ter Claude Code ou Codex instalado antes do Tallos?
Não. Você pode instalar o Tallos primeiro e adicionar os agentes depois em Configurações → Conexões, que roda o comando oficial de instalação de cada fabricante e abre o login.
O Tallos é assinado e notarizado no macOS?
Sim. Os builds de release para macOS são assinados e notarizados. Mesmo assim o macOS pede confirmação na primeira abertura, como faz com qualquer app baixado da internet.
O Tallos precisa de permissão de administrador no Mac?
Copiar um app para a pasta Aplicativos pode pedir sua senha em Macs gerenciados. O Tallos em si roda como um app comum de usuário.
Como desinstalo o Tallos do Mac?
Feche o Tallos e arraste o app de Aplicativos para o Lixo. Seus repositórios não são alterados; os workspaces são git worktrees comuns que você remove com git worktree remove.