Sua primeira tarefa no Tallos: do projeto ao diff revisado

O que eu preciso antes da primeira tarefa?

Você precisa do Tallos instalado, de uma CLI de agente instalada e conectada e de um repositório git na máquina. Se ainda não instalou o Tallos, siga o guia de macOS ou de Windows. Se nenhum agente estiver conectado, abra Configurações → Conexões e siga como conectar seus agentes.

• Tallos no macOS 13+ ou Windows 10+.
• Um agente conectado, como Claude Code, Codex ou Gemini CLI.
• Um repositório git com a branch principal limpa. Um projeto pessoal é um bom primeiro alvo.
• Uma tarefa pequena e verificável. Uma correção de bug, um teste ou uma mudança pequena de interface que você confere em minutos.

Como rodar minha primeira tarefa no Tallos, passo a passo?

1. 1

   Termine as boas-vindas

   Na primeira abertura, escolha o idioma e o agente padrão em Qual agente de IA você usa? e clique em Continuar. Por enquanto, deixe desligado Deixar os agentes executarem comandos sem perguntar, em Avançado: o agente vai pedir permissão antes de rodar comandos.

2. 2

   Abra um projeto

   Clique em Escolher uma pasta e selecione o repositório, ou use Clonar de uma URL. O Tallos lê o estado do git e usa a branch padrão como base de onde todo workspace novo parte.

3. 3

   Comece a tarefa num workspace próprio

   Clique em Novo workspace na barra lateral, ou no + ao lado do projeto. Um tour curto aponta os três campos: Projeto, o nome da tarefa (deixe em branco e o Tallos nomeia a partir da sua primeira mensagem) e Agente. Crie. O Tallos roda git worktree add em segundo plano e mostra o progresso na aba nova.

4. 4

   Descreva o que você precisa

   Agentes compatíveis, como Claude Code e Codex, abrem num chat limpo por padrão. Escreva a tarefa com suas palavras: o que mudar, onde, e como você vai saber que funcionou. Agentes sem suporte a chat abrem direto no terminal.

5. 5

   Acompanhe o agente

   Siga o progresso no chat ou clique em Ver terminal no topo do painel para ver a CLI crua. A barra lateral mostra quais workspaces estão trabalhando e quais precisam de você. Responda aos pedidos de permissão conforme aparecem.

6. 6

   Teste um segundo agente (opcional)

   Quando aparecer o tour Tente um segundo agente, clique em Tentar outro agente. O Tallos entrega a mesma tarefa a outro agente, em outra cópia do projeto, e você compara os dois resultados lado a lado.

7. 7

   Revise as mudanças

   Quando o agente terminar, clique em Revisar mudanças. Você vê cada alteração contra a branch de onde o workspace partiu. Deixe notas em linhas específicas e use Enviar notas para para devolvê-las ao agente num lote só.

8. 8

   Fique com o trabalho ou descarte

   Para ficar com o trabalho, faça stage e commit em Source Control, dê push e clique em Criar PR. Para descartar, clique com o botão direito no workspace e exclua; o Tallos pede confirmação e remove a pasta e a branch. Em nenhum dos casos seu checkout principal mudou.

Quer testar o ciclo no seu repositório? Baixe o Tallos.

Baixar o Tallos →

O que é um workspace no Tallos?

Um workspace no Tallos é uma cópia separada do repositório em disco, criada com git worktree, com branch própria, arquivos próprios e sessões de agente próprias. Por isso o tour diz que o original fica seguro: o agente edita a cópia, nunca o seu checkout principal. E é por isso que dois agentes trabalham ao mesmo tempo sem mexer nos arquivos um do outro. O guia de git worktrees explica o mecanismo.

O que é uma boa primeira tarefa para um agente de IA?

Uma boa primeira tarefa é pequena, específica e fácil de conferir. A ideia é aprender o ciclo, não testar o limite do agente. Diga o arquivo ou a funcionalidade, o comportamento esperado e como verificar.

Como decido se fico com o trabalho do agente?

Fique com o trabalho só quando o diff faz o que você pediu e nada além. Leia cada arquivo, rode os testes e procure mudanças fora do escopo. Se estiver perto mas errado, anote as linhas e devolva as notas em vez de corrigir na mão. O checklist completo está em como revisar código gerado por IA, e a revisão de diff mostra cada ferramenta do painel.

Solução de problemas: e se a primeira tarefa travar?

• A criação do workspace falha. A branch base pode não ter sido buscada. Rode git fetch origin no projeto ou escolha outra branch de partida.
• O agente não inicia. Rode a CLI dele (claude, codex, gemini…) num terminal. Se falhar lá, reinstale ou entre de novo por Configurações → Conexões.
• O agente fica esperando para sempre. Provavelmente ele está pedindo permissão. Abra o chat ou clique em Ver terminal e responda.
• Testes ou servidor de desenvolvimento falham no workspace. Um worktree novo não tem os arquivos ignorados pelo git, como node_modules ou .env. Instale as dependências no workspace ou liste os arquivos num .worktreeinclude na raiz do repositório para o Tallos copiá-los nos workspaces novos.
• Você não acha a revisão. Clique em Revisar mudanças no tour ou abra Source Control na barra lateral direita do workspace.

O que testar depois da primeira tarefa?

Rode a mesma tarefa em dois agentes e compare os diffs; depois leia como rodar agentes de IA em paralelo. Quando quiser que um agente líder divida e supervisione o trabalho por você, siga para sua primeira squad.

Teste no seu próprio repositório.

Baixar o Tallos →