O que é o Grok CLI?
O Grok CLI é o agente de código com IA da xAI para o terminal, executado com o comando grok. Ele trabalha no projeto da pasta atual — lê código, edita arquivos e roda comandos — e entra com sua conta do Grok ou usa uma chave de API da xAI.
O Tallos é um ambiente de desenvolvimento com agentes para desktop que instala, conecta e inicia o Grok CLI de verdade, roda várias sessões dele em workspaces isolados e o coloca ao lado do Claude Code, do Codex e dos seus outros agentes.
Como configuro o Grok CLI no Tallos?
Abra Configurações → Conexões, instale o Grok CLI pelo card dele, entre na conta e defina como agente padrão. Um grok que já está no PATH é detectado automaticamente.
- 1
Instale
Clique em Instalar. O Tallos mostra o comando oficial antes de rodar:
npm install -g @xai-official/grokoucurl -fsSL https://x.ai/cli/install.sh | bashno macOS, enpm install -g @xai-official/grokno Windows (precisa do Node.js). - 2
Entre na conta
Clique em Entrar para rodar
grok loginnum terminal. Ou clique em Usar chave de API: o Tallos guarda aXAI_API_KEYno armazenamento seguro do computador e a passa só para o Grok CLI sempre que o inicia. - 3
Confira os modelos
Abra Modelos no card. O Tallos lê a lista do seu Grok CLI conectado, então a lista bate com o que a CLI oferece a você.
- 4
Defina como padrão e comece
Em Configurações → Agentes, marque o Grok como Agente padrão. Adicione um repositório, clique em + para um workspace e descreva a tarefa; o Tallos inicia o
groknum worktree novo com o seu prompt.
Vai configurar vários agentes de uma vez? Siga conectar seus agentes.
Como rodo várias sessões do Grok CLI em paralelo?
Crie um workspace por tarefa. Cada workspace é um git worktree separado, com branch, arquivos e terminais próprios, então sessões paralelas do Grok nunca escrevem no mesmo diretório de trabalho.
- Acompanhe tudo junto. Divida os painéis em qualquer direção; os hooks do Grok no Tallos informam trabalhando, esperando e concluído na barra lateral.
- Prompt chega inteiro. O Tallos passa a tarefa ao
grokcomo argumento, depois de um separador--, então um prompt que começa com uma palavra como “help” não é lido como comando do Grok. - Revisão por branch. Cada workspace tem seu diff; comente linhas e mande o feedback de volta para aquela sessão.
- Retome depois. Sessões do Grok aparecem no Histórico de Sessões do Agente; Retomar roda
grok --resume <id>na pasta certa.
O modelo de isolamento está explicado em workspaces paralelos.
Conecte o Grok CLI e rode em paralelo.
O Grok CLI abre em chat ou no terminal?
Em chat, por padrão, para sessões no seu computador. O Tallos lê a transcrição do Grok e mostra mensagens e chamadas de ferramenta para leitura, enquanto o Grok CLI continua rodando por baixo.
- Seletor de modelo. Escolha o modelo antes da primeira mensagem (passado como
-mna inicialização) ou troque no meio da sessão (enviado como/model). A lista vem do seu Grok CLI conectado. - Seletor de esforço. Defina o esforço de raciocínio na inicialização (
--reasoning-effort) ou no meio da sessão (/effort). As opções acompanham o modelo escolhido. - Ver terminal / Voltar ao chat levam à interface bruta do Grok e de volta a qualquer momento.
- Quer sempre o terminal? Em Configurações → Agentes → Visão do agente, escolha Terminal.
Leia mais em chat nativo.
Como uso o Grok CLI junto com outros agentes?
Coloque o Grok numa squad — um agente líder mais membros — ou rode-o nos próprios workspaces ao lado de outros agentes. Numa squad, cada posição escolhe agente, modelo e esforço, e o Tallos aplica o modelo e o esforço do Grok ao iniciar aquele membro.
- Uma das três tentativas. Em *3 tentativas, escolhe a melhor*, o Grok pode atacar o mesmo objetivo que o Claude Code e o Codex; o líder recomenda um resultado.
- Construtor ou revisor. Em *Construir + revisar*, o Grok pode construir enquanto outro agente revisa, ou o contrário.
- Líder. Qualquer agente detectado pode liderar, inclusive o Grok. Ele planeja, despacha e reporta dentro dos seus limites: 5 rodadas e 4 membros ao mesmo tempo por padrão, até 20 rodadas e 12 membros.
Cada membro trabalha no próprio worktree, e nada é mesclado sem o seu aceite.
O que o Tallos acrescenta ao Grok CLI?
| Recurso | Grok CLI sozinho | Grok CLI no Tallos |
|---|---|---|
| Sessões em paralelo | Você abre mais terminais e monta os git worktrees | Um workspace por tarefa, cada um com worktree e branch próprios |
| Instalação e login | Você roda a instalação e o grok login | Instalar, entrar ou salvar chave de API em Configurações → Conexões |
| Chave de API | Exportar XAI_API_KEY no shell | Guardada no armazenamento seguro, passada só ao Grok CLI |
| Interface | Interface de terminal | Chat com seletores de modelo e esforço, terminal a um clique |
| Status da sessão | Visível no terminal dela | Trabalhando / esperando / concluído de todas as sessões na barra lateral |
| Sessões antigas | grok --resume a partir da pasta certa | Histórico pesquisável de todos os agentes, Retomar com um clique |
| Outros agentes | Ferramentas separadas | Mesmo app; squads com líder, membros e melhor de N |
Perguntas frequentes
Preciso de outra assinatura para usar o Grok CLI no Tallos?
Não. O Tallos usa seu login do Grok ou sua chave de API da xAI e não revende acesso a modelos.
Como o Tallos sabe que estou conectado ao Grok?
Ele lê o arquivo de sessão local do Grok CLI. Com o login feito, o card do Grok em Configurações → Conexões mostra Conectado.
Consigo trocar o modelo do Grok no meio da sessão?
Sim. Na visão de chat, o seletor de modelo envia /model para a sessão em andamento, e o seletor de esforço envia /effort.
O chat do Grok funciona via SSH?
Não. O chat do Grok precisa da transcrição da sessão no seu próprio computador, então sessões remotas do Grok abrem na visão de terminal.
O Grok e o Claude Code podem trabalhar no mesmo repositório ao mesmo tempo?
Sim. Cada um roda no próprio worktree, numa branch própria, então as mudanças nunca colidem. Compare os diffs e fique com o que preferir.
O Grok CLI funciona no Tallos para Windows?
Sim. No Windows 10+, a tela de Conexões instala o Grok CLI via npm, então instale o Node.js antes.