6 pontos por GN⁺ 5 시간 전 | 1 comentários | Compartilhar no WhatsApp
  • 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

 
GN⁺ 5 시간 전
Comentários no Hacker News
  • Esse codebase tem mais recursos do que eu esperava. Por exemplo, https://github.com/xai-org/grok-build/blob/b189869b7755d2b48... é um renderizador de terminal independente que representa alguns diagramas Mermaid com caracteres Unicode de desenho de caixa
  • Organizei o assunto [num post de blog][0], e pelo menos desta vez não terminou na habitual resposta promocional padronizada. Já estão surgindo vários projetos derivados
    [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_body para 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 MemoryBackend em 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
    • Ao ver o [3], ele me lembrou o antigo projeto OpenGrok da Sun, uma forma de LXR muito aprimorada: https://oracle.github.io/opengrok/
    • Acho que são todos forks sem muita relevância e que vão desaparecer em menos de 1 ano. É só salvar nos favoritos e conferir depois
  • É lamentável que tenham vazado dados privados para fora. O modelo em si é excelente, a ponto de eu sentir que é melhor que o Opus 4.8, e o ambiente de execução também é muito fluido, com potencial para evoluir ao mais alto nível
    • Para mim não parece nada com o Opus. Eu sempre acabo voltando para o Opus para corrigir ou finalizar o que o Grok gerou, e a sensação é de que está mais perto do Sonnet 3
    • Tive uma impressão parecida e, pelo que vi até agora, a capacidade de design visual do Grok 4.5 é melhor que a do Fable. Como ele ainda parece 2 a 3 vezes mais rápido, é uma escolha fácil
    • Dois dias atrás, tive um problema estranho com o Cursor-Grok-4.5: ele continuava repetindo respostas e entrava em loop, ou simplesmente encerrava no meio do raciocínio. Pode ter sido por eu estar usando omp, mas ainda não é a ferramenta mais estável
      Mesmo assim, quando funciona direito, é muito bom, e por 10 dólares por mês é absurdamente barato
    • Também é lamentável que o líder dessa empresa tenha vazado dados do governo para fora
    • A velocidade de build do Grok 4.5 é impressionante, dá a sensação de experimentar antes do tempo as tecnologias que ainda estão por vir
  • Isso não é tanto uma decisão correta quanto uma decisão tática. Se sua participação de mercado não chega a 1%, sua reputação é ruim e ainda descobrem que você estava enviando dados dos usuários, abrir o código é uma das poucas jogadas que restam para sair do atoleiro
    • Outra tática seria simplesmente encerrar o negócio de IA. Ninguém está obrigando a continuar queimando dinheiro, todos os fundadores da xAI já saíram e a marca do produto está destruída. Melhor abandonar a IA e voltar a fazer espaçonaves como empresa de foguetes
    • Às vezes, a ação que é vantajosa taticamente também é a ação correta
    • Com certeza é uma jogada inteligente que pode ser usada para ultrapassar os concorrentes
    • Agora não conheço ninguém por perto que confie no Grok Build, e pelos próximos meses também pretendo desconfiar do Cursor
    • “Tático” é a palavra certa no sentido de que você pode vencer taticamente e mesmo assim fracassar estrategicamente. Todo o império de memes do Musk depende de clima e imagem, então no momento em que a barragem rachar tudo pode ruir
      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
  • No momento, eu recomendaria usar https://pi.dev/ em vez de usar o Grok Build via assinatura da xAI
    • Não sei o que significa “assinatura da xAI”. Pelo que eu sabia, uma assinatura do Grok não dá acesso à API
      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
    • Queria entender por que você recomenda o Pi em vez do 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 bom
    • A ideia do Pi é boa, mas fico me perguntando por que escolheram uma linguagem compilada em vez de TypeScript
  • Se você já pagou 60 bilhões de dólares pelo Cursor, será que ainda há motivo para manter isso também?
    • Usuários do Cursor estão acostumados a usar modelos de vários provedores juntos, mas a xAI quer aumentar o uso dos seus próprios modelos
    • É bem provável que o Grok Build acabe descontinuado, e é comum abrir um produto como open source antes de encerrar o suporte. O Cursor é incomparavelmente melhor que o Grok Build
    • É bem possível que tenham aberto o código por causa da aquisição do Cursor, e ao mesmo tempo isso também pode melhorar um pouco o problema de reputação
  • Vi relatos de alguns desenvolvedores que usaram bem o Grok, então pode valer a pena considerar como alternativa aos modelos chineses de que eu gosto. Mas também é difícil abrir mão do agente do Pi
    • O Grok Build parece mais rápido que omp ou 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
    • Eu uso o Grok dentro do Pi
  • Pela funcionalidade que oferece, a quantidade de código é inacreditavelmente grande. Não parece um codebase projetado de forma intencional
    • A quantidade de código necessária para criar um ambiente de execução para agentes pode ser muito maior do que se imagina
    • Isso soa como aquela subestimação do tipo “num fim de semana eu consigo fazer o Uber.app
  • Tem muita gente apostando de novo no fracasso do Elon, mas eu faria o contrário e apostaria no Elon
    • Você também entrou nas apostas sobre a direção totalmente autônoma?
    • Não é tanto uma aposta contra ele, e sim uma aposta pelo futuro da humanidade. Independentemente de como o Elon se avalie, o que ele fez nos últimos 5 anos foi prejudicial para a humanidade e está ficando cada vez pior