- O código-fonte em Rust e o runtime de agente que compõem o Grok Build, agente de codificação com IA baseado em terminal da SpaceXAI, foram abertos, e o repositório é sincronizado periodicamente a partir do monorepo da SpaceXAI
- Na TUI em tela cheia, ele oferece suporte a compreensão de codebases, modificação de arquivos, execução de comandos de shell, busca na web e gerenciamento de tarefas de longa duração, podendo ser executado de forma interativa, em modo headless ou integrado via Agent Client Protocol (ACP)
- Há binários pré-compilados para macOS, Linux e Windows, e a compilação a partir do código-fonte exige Rust e protoc; apenas macOS e Linux são oficialmente suportados como hosts de build
- O código é dividido em crates Rust responsáveis separadamente pela TUI, pelo runtime de agente, pela implementação de ferramentas e pelo sistema de arquivos do host, VCS, execução e checkpoints
- O código próprio é distribuído sob a Apache License 2.0, mas não aceita contribuições externas; códigos de terceiros e vendorados mantêm suas licenças originais
Função e formas de execução do Grok Build
- Grok Build é o agente de codificação com IA baseado em terminal da SpaceXAI, e o nome do comando é
grok
- Ele funciona como uma TUI em tela cheia e realiza as seguintes tarefas
- Compreensão de codebases
- Edição de arquivos
- Execução de comandos de shell
- Busca na web
- Gerenciamento de tarefas de longa duração
- Há suporte a três formas de execução
- Uso interativo no terminal
- Execução em modo headless em scripts ou CI
- Integração embutida no editor por meio do Agent Client Protocol (ACP)
- O repositório contém o código-fonte em Rust da CLI/TUI
grok e do runtime de agente, sendo sincronizado periodicamente a partir do monorepo da SpaceXAI
- Informações do produto podem ser consultadas em x.ai/cli, e a documentação completa em docs.x.ai/build/overview
Instalação de binários e autenticação
- Binários pré-compilados são distribuídos para macOS, Linux e Windows
curl -fsSL https://x.ai/cli/install.sh | bash # macOS / Linux / Git Bash
irm https://x.ai/cli/install.ps1 | iex # Windows PowerShell
grok --version
- Alterações por release e melhorias de recursos estão organizadas no changelog
- O artefato gerado na compilação do código-fonte se chama
xai-grok-pager, e na distribuição oficial ele é fornecido com o nome grok
- Na primeira execução, ele abre o navegador para realizar a autenticação
Requisitos para compilar a partir do código-fonte
- A compilação exige Rust e
protoc
- A versão do toolchain Rust é fixada em
rust-toolchain.toml, e o rustup a instala automaticamente na primeira compilação
- A geração de código de Protocol Buffers tenta usar primeiro o launcher dotslash em
bin/protoc; se não existir, usa o protoc disponível no PATH ou em $PROTOC
- macOS e Linux são hosts de build suportados
- A compilação a partir do código-fonte no Windows é oferecida apenas em base de best-effort e atualmente não é testada nesta árvore de código-fonte
cargo run -p xai-grok-pager-bin
cargo build -p xai-grok-pager-bin --release
cargo check -p xai-grok-pager-bin
cargo run compila e executa a TUI
- O build de release gera o binário
target/release/xai-grok-pager
cargo check é usado para verificação rápida
Estrutura do repositório
crates/codegen/xai-grok-pager-bin
- É o pacote raiz de composição e compila o binário
xai-grok-pager
crates/codegen/xai-grok-pager
- Responsável pela TUI, incluindo scrollback, prompts, modais e renderização
crates/codegen/xai-grok-shell
- Fornece o runtime de agente e os pontos de entrada leader, stdio e headless
crates/codegen/xai-grok-tools
- Inclui a implementação de ferramentas como terminal, edição de arquivos e busca
crates/codegen/xai-grok-workspace
- Responsável pelo sistema de arquivos do host, sistema de controle de versão, execução de comandos e checkpoints
- Demais
crates/codegen/...
- Incluem crates necessários para a CLI, como configuração, MCP, Markdown e sandboxing
crates/common/, crates/build/, prod/mc/
- São pequenos crates-folha compartilhados incluídos no fechamento de dependências
third_party/
- Contém o código-fonte upstream vendorado da stack de diagramas Mermaid
- O
Cargo.toml na raiz é gerado com base nos membros do workspace, versões de dependência, lints e perfis, portanto deve ser tratado como somente leitura
- Ao fazer alterações, recomenda-se modificar os
Cargo.toml de cada crate individualmente
Escopo da documentação
- O guia do usuário está incluído em
crates/codegen/xai-grok-pager/docs/user-guide/
- A documentação cobre os seguintes tópicos
- Primeiros passos
- Atalhos de teclado
- Comandos com barra
- Configuração e temas
-
Servidor MCP
- Skills e plugins
- Hooks
- Modo headless
- Sandboxing
Fluxo de trabalho de desenvolvimento
- Como compilar o workspace inteiro é lento, recomenda-se sempre verificar especificando crates individuais
cargo check -p <crate>
cargo test -p xai-grok-config
cargo clippy -p <crate>
cargo fmt --all
- Testes e Clippy também são executados por crate
- As configurações do Clippy ficam em
clippy.toml na raiz do repositório, e as configurações de formatação Rust em rustfmt.toml
Contribuição e licença
- O repositório não aceita contribuições externas
- O código próprio do repositório é distribuído sob a Apache License 2.0
- Códigos de terceiros e vendorados mantêm suas respectivas licenças originais
THIRD-PARTY-NOTICES inclui avisos sobre dependências de crates.io e Git, temas de UI empacotados e ports dentro da árvore de código-fonte
- Esses ports internos incluem implementações de ferramentas de
openai/codex e sst/opencode
crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md contém o texto das licenças dos ports de Codex e OpenCode, além do aviso de modificações da Apache §4(b)
third_party/NOTICE fornece um índice de avisos da stack Mermaid vendorada
1 comentários
Comentários no Hacker News
Também organizei melhor no blog o processo de exploração do código do Grok: https://simonwillison.net/2026/Jul/15/grok-build/
[thedavidweng/gork-build][1] é um fork de privacidade no estilo VSCodium que troca grok por “gork” e remove telemetria do fornecedor, retenção de dados ativada por padrão e atualizações automáticas da x.ai
[DigiGoon/digi-grok-build][2] é o CLI multiprovedor “dgrok”, compilado a partir do código-fonte em vez de usar o CDN da x.ai, e [victor-software-house/open-grok][3] oferece suporte a todos os provedores
[LukaMucko/grok-build][4] adiciona
extra_bodypara campos de solicitação específicos de cada provedor, [RapidAI/grok-build-desktop][5] adiciona uma GUI desktop em Tauri[mazdak/grok-build][6] traz o tema Catppuccin, [thomas9120/grok-build-archival][7] um script para desativar a telemetria do Windows, e [saqoah/grok-build][8] fornece um
MemoryBackendem Kotlin[0]: https://news.ycombinator.com/item?id=48928913
[1]: https://github.com/thedavidweng/gork-build
[2]: https://github.com/DigiGoon/digi-grok-build
[3]: https://github.com/victor-software-house/open-grok
[4]: https://github.com/LukaMucko/grok-build
[5]: https://github.com/RapidAI/grok-build-desktop
[6]: https://github.com/mazdak/grok-build
[7]: https://github.com/thomas9120/grok-build-archival
[8]: https://github.com/saqoah/grok-build
omp, mas ainda não é a ferramenta mais estávelMesmo assim, quando funciona direito, é muito bom, e por 10 dólares por mês é absurdamente barato
O valor de mercado das empresas em que ele se envolveu não parece racional, e o colapso pode começar só pelo fato de fracassar completamente na disputa com as principais empresas de IA
Fui conferir e as assinaturas da linha X Premium também dão acesso ao Grok Build, com suporte oficial a vários ambientes de execução de terceiros
opencode. Estou tentando ver para quais soluções abertas as pessoas estão migrando. O Codex também é meio aberto, embora as contribuições sejam fechadas, e é bem bomompou Claude Code, mas não sei exatamente por quê. Depois que desativei o upload de código, ele deixou de responder instantaneamente em poucos milissegundos como antes