# A CLI tallos e as skills incluídas: deixe seus agentes pilotarem o Tallos

> A CLI `tallos` é a interface de linha de comando de um Tallos em execução. Agentes e scripts usam o comando para criar worktrees, ler e mandar texto para terminais, automatizar o navegador integrado, agendar automações e coordenar outros agentes. O Tallos traz skills que ensinam esses comandos e as instala sozinho, offline, nos agentes que encontra na primeira abertura.

- Canonical: https://runtallos.com/pt/recursos/cli-e-skills
- English: https://runtallos.com/features/tallos-cli-and-skills.md
- Atualizado em: 2026-09-29
- Section: Recursos

## Em resumo

- Um comando `tallos` no macOS e no Windows
- Worktrees, terminais, arquivos, navegador, automações, orquestração
- 7 skills incluídas, instaladas na primeira abertura sem download
- Saída `--json` em todos os comandos para os agentes
- Guias na mesma versão do app com `tallos skills get`

## O que é a CLI tallos?

A **CLI `tallos`** é uma ferramenta de linha de comando que controla o Tallos em execução a partir de qualquer shell. Você pode usar em scripts, mas quem mais usa é o agente. O Claude Code num workspace cria um segundo workspace, inicia o Codex lá com um prompt, espera terminar e lê a saída, sem você clicar em nada.

Ela vem junto com o app. O Tallos registra o comando `tallos` no seu `PATH` pelas Configurações, e os terminais abertos pelo Tallos já sabem onde encontrá-lo. A maioria dos comandos aceita `--json` para saída legível por máquina, e `tallos agent-context` imprime o schema completo de comandos para o agente descobrir o que existe em vez de chutar flags.

> **Precisa do app aberto** — A maioria dos comandos conversa com o Tallos em execução. Se ele estiver fechado, `tallos open` abre o app e espera ficar pronto; `tallos status` mostra se ele está acessível.

## O que os agentes fazem com o comando tallos?

| Grupo | O que o agente faz | Exemplo |
| --- | --- | --- |
| `worktree` | Cria, lista, inspeciona, comenta e remove workspaces isolados | `tallos worktree create --name fix-login --agent codex --prompt "..."` |
| `terminal` | Cria, divide, lê, espera e manda texto para terminais | `tallos terminal wait --for tui-idle --timeout-ms 30000` |
| `file` | Abre arquivos, diffs ou todos os arquivos alterados no editor | `tallos file open-changed --mode diff` |
| Navegador | Navega, tira snapshot, clica, preenche, faz screenshot, emula dispositivos | `tallos snapshot` e depois `tallos click --element e3` |
| `automations` | Cria, edita, roda e inspeciona execuções agendadas | `tallos automations run <id>` |
| `orchestration` | Tarefas, workers supervisionados, mensagens e pontos de decisão entre agentes | `tallos orchestration worker-start --task <id> --agent claude` |
| `linear` | Lê, busca, comenta e cria issues no Linear | `tallos linear issue ENG-142 --comments` |
| `emulator` | Toca, digita e inspeciona um iOS Simulator ou dispositivo Android | `tallos emulator tap 0.5 0.8` |
| `computer` | Opera janelas de apps nativos pela árvore de acessibilidade | `tallos computer get-app-state --app <app>` |
| `search` | Busca de texto completo nas sessões de agentes anteriores | `tallos search "stripe webhook"` |

_Principais grupos de comandos_

É a mesma base que move as [squads](https://runtallos.com/pt/recursos/squads): o agente líder coordena os membros pela orquestração, faz perguntas para você com `tallos squad ask` e entrega o resultado com `tallos squad report`.

## Como fica uma passagem de tarefa entre agentes?

Este é um repasse típico que o agente roda sozinho: abre um workspace novo para uma subtarefa, inicia outro agente nele, espera e lê o que aconteceu.

```bash
tallos worktree create --name billing-audit --agent codex \
  --prompt "Audite a página de billing no mobile" --json
tallos terminal list --worktree name:billing-audit --json
tallos terminal wait --terminal <handle> --for tui-idle --timeout-ms 900000 --json
tallos terminal read --terminal <handle> --limit 200 --json
```

Cada workspace tem sua branch e sua cópia de trabalho, então o segundo agente nunca mexe nos arquivos do primeiro. É a base do [desenvolvimento multiagente](https://runtallos.com/pt/desenvolvimento-multiagente).

## O que são as skills do Tallos?

Uma **skill** é uma pasta com um arquivo `SKILL.md` que diz ao agente de código quando e como usar uma ferramenta. O Tallos já traz as skills dentro do app. Na primeira abertura, ele instala tudo nos agentes que encontra no seu computador: offline, sem `npx`, sem baixar repositório e sem etapa de configuração para você.

| Skill | O que ensina ao agente |
| --- | --- |
| `tallos-cli` | Worktrees, terminais, repositórios, automações, repasses e o navegador integrado via `tallos` |
| `orchestration` | Supervisionar outros agentes: tarefas, despacho, mensagens, perguntas bloqueantes, pontos de decisão |
| `tallos-linear` | Trabalhar a partir de um ticket do Linear: ler, mudar status, comentar, anexar o PR, criar tickets de continuação |
| `tallos-emulator` | Controlar um iOS Simulator no macOS pelo painel do emulador |
| `tallos-emulator-android` | Controlar um emulador ou aparelho Android via adb no macOS ou no Windows |
| `tallos-per-workspace-env` | Montar um ambiente descartável (sandbox, VM, host SSH ou container) por workspace |
| `computer-use` | Operar janelas de apps nativos quando nenhuma CLI ou API resolve |

_Skills incluídas no Tallos_

- **Sempre atualizadas.** Nas aberturas seguintes, o Tallos repara skills ausentes ou desatualizadas para bater com a versão do app.
- **Suas skills ficam intactas.** O Tallos só gerencia as próprias skills; as que você instalou de outras fontes nunca são tocadas.
- **Reinstale quando quiser.** Em Configurações → Skills do agente há **Instalar agora** e **Reinstalar**. Se nenhum agente foi encontrado ainda, [conecte seus agentes](https://runtallos.com/pt/aprenda/conectar-seus-agentes) primeiro.

## Entregue as chaves para os seus agentes

> Instale o Tallos, abra seus agentes e eles já sabem criar workspaces e pilotar o navegador. → https://runtallos.com/signup

## Quais agentes recebem as skills?

O Tallos instala as skills nos agentes detectados que leem uma pasta de skills, entre eles [Claude Code](https://runtallos.com/pt/integracoes/claude-code), [Codex](https://runtallos.com/pt/integracoes/codex), [Gemini CLI](https://runtallos.com/pt/integracoes/gemini-cli) e Grok. Cada agente recebe as skills no lugar que ele já lê, então não há nada para configurar.

As skills instaladas são curtas de propósito. Elas dizem ao agente quando recorrer ao Tallos e então carregam o guia completo pela CLI com `tallos skills get <nome>`. O guia vem do mesmo build do app, então as flags documentadas nunca ficam diferentes do que o comando aceita.

```bash
tallos skills list
tallos skills get tallos-cli
tallos skills get orchestration --full
```

## Por que CLI e skills em vez de só um servidor MCP?

Todo agente de código já sabe rodar comandos no shell, então uma CLI funciona em qualquer um deles sem suporte a protocolo extra. As skills acrescentam o "quando" e o "como". Os agentes que suportam MCP continuam com seus servidores MCP, e o Tallos mostra as configurações MCP definidas em cada repositório; as duas abordagens convivem.

**Agente sem a CLI tallos**
- Roda `git worktree` na mão e shells improvisados
- Não enxerga nem espera os terminais de outros agentes
- Descreve bugs de interface a partir de prints que você cola

**Agente com a CLI tallos e as skills**
- Cria workspaces gerenciados pelo Tallos que aparecem na barra lateral
- Lê, espera e manda mensagem para os terminais de outros agentes
- Pilota o navegador integrado e confere o próprio trabalho

## Perguntas frequentes

### O que é o comando tallos?

`tallos` é a interface de linha de comando que vem com o app do Tallos. Com ela, agentes e scripts controlam o Tallos em execução: worktrees, terminais, arquivos, navegador integrado, automações e orquestração.

### Preciso instalar as skills do Tallos na mão?

Não. O Tallos instala as skills incluídas automaticamente na primeira abertura, nos agentes de código que encontra, sem baixar nada. Dá para reinstalar em Configurações → Skills do agente.

### Quais skills vêm com o Tallos?

`tallos-cli`, `orchestration`, `tallos-linear`, `tallos-emulator`, `tallos-emulator-android`, `tallos-per-workspace-env` e `computer-use`.

### O Tallos vai sobrescrever skills que eu mesmo escrevi?

Não. O Tallos só instala e repara as próprias skills. Skills de outras fontes ficam como estão.

### O Claude Code consegue abrir uma worktree nova e iniciar o Codex nela?

Consegue. Com a skill `tallos-cli`, o Claude Code roda `tallos worktree create --agent codex --prompt "..."` e depois espera e lê aquele terminal com `tallos terminal wait` e `tallos terminal read`.

### A CLI tallos funciona no Windows?

Funciona. O comando `tallos` é registrado no macOS e no Windows, e os terminais abertos pelo Tallos encontram o comando sozinhos.

### Como o agente descobre as flags certas?

Ele roda `tallos skills get <nome>` para ler o guia da mesma versão do app, ou `tallos agent-context` para o schema de comandos legível por máquina, em vez de chutar de memória.

---

**Rode seus agentes em paralelo com o Tallos** — Claude Code, Codex, Gemini e mais de 30 agentes — cada um no seu workspace, com squads, chat, terminais e revisão num só app. Usa as assinaturas que você já tem.

https://runtallos.com/signup (macOS 13+ · Windows 10+)