- Le code source Rust et le runtime d’agent qui composent Grok Build, l’agent de codage IA basé sur le terminal de SpaceXAI, ont été publiés ; le dépôt est synchronisé régulièrement depuis le monorepo de SpaceXAI
- Dans une TUI plein écran, il prend en charge la compréhension de bases de code, la modification de fichiers, l’exécution de commandes shell, la recherche web et la gestion de tâches longues ; il peut s’exécuter en mode interactif, headless ou intégré via l’Agent Client Protocol (ACP)
- Des binaires précompilés sont fournis pour macOS, Linux et Windows ; la compilation depuis les sources nécessite Rust et protoc, et seuls macOS et Linux sont officiellement pris en charge comme hôtes de build
- Le code est réparti en crates Rust responsables respectivement de la TUI, du runtime d’agent, de l’implémentation des outils, du système de fichiers hôte, du VCS, de l’exécution et des checkpoints
- Le code propre au projet est distribué sous Apache License 2.0, mais les contributions externes ne sont pas acceptées ; le code tiers et vendored conserve ses licences existantes
Rôle et modes d’exécution de Grok Build
- Grok Build est l’agent de codage IA basé sur le terminal de SpaceXAI, et le nom de la commande est
grok
- Il fonctionne sous forme de TUI plein écran et effectue les tâches suivantes
- Comprendre une base de code
- Modifier des fichiers
- Exécuter des commandes shell
- Rechercher sur le web
- Gérer des tâches de longue durée
- Trois modes d’exécution sont pris en charge
- Utilisation interactive dans le terminal
- Exécution en mode headless dans des scripts ou en CI
- Intégration dans un éditeur via l’Agent Client Protocol (ACP)
- Le dépôt contient les sources Rust de la CLI/TUI
grok et du runtime d’agent, et il est synchronisé régulièrement depuis le monorepo de SpaceXAI
- Les informations produit sont disponibles sur x.ai/cli, et la documentation complète sur docs.x.ai/build/overview
Installation des binaires et authentification
- Les binaires précompilés sont distribués pour macOS, Linux et 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
- Les correctifs et améliorations de fonctionnalités par version sont récapitulés dans le changelog
- Le nom de l’artefact produit par la compilation depuis les sources est
xai-grok-pager, tandis que la version installée officiellement le fournit sous le nom grok
- Au premier lancement, un navigateur s’ouvre pour procéder à l’authentification
Conditions de compilation depuis les sources
- La compilation nécessite Rust et
protoc
- La version de la toolchain Rust est figée dans
rust-toolchain.toml, et rustup l’installe automatiquement lors du premier build
- La génération du code Protocol Buffers utilise d’abord le lanceur dotslash dans
bin/protoc, puis se rabat, s’il est absent, sur protoc présent dans PATH ou $PROTOC
- macOS et Linux sont des hôtes de build pris en charge
- La compilation depuis les sources sous Windows n’est fournie qu’en best-effort et n’est actuellement pas testée dans cet arbre de sources
cargo run -p xai-grok-pager-bin
cargo build -p xai-grok-pager-bin --release
cargo check -p xai-grok-pager-bin
cargo run compile et lance la TUI
- Le build de release génère le binaire
target/release/xai-grok-pager
cargo check sert à une vérification rapide
Structure du dépôt
crates/codegen/xai-grok-pager-bin
- Package racine de composition qui compile le binaire
xai-grok-pager
crates/codegen/xai-grok-pager
- Prend en charge la TUI, notamment le scrollback, les prompts, les modales et le rendu
crates/codegen/xai-grok-shell
- Fournit le runtime d’agent et les points d’entrée leader, stdio et headless
crates/codegen/xai-grok-tools
- Contient les implémentations d’outils comme le terminal, l’édition de fichiers et la recherche
crates/codegen/xai-grok-workspace
- Prend en charge le système de fichiers hôte, le système de gestion de versions, l’exécution de commandes et les checkpoints
- Le reste de
crates/codegen/...
- Contient les crates nécessaires à la CLI, notamment configuration, MCP, Markdown et sandbox
crates/common/, crates/build/, prod/mc/
- Petites crates feuilles partagées incluses dans la clôture des dépendances
third_party/
- Contient les sources upstream vendored de la pile de diagrammes Mermaid
- Le
Cargo.toml racine est un fichier généré à partir des membres du workspace, des versions de dépendances, des lints et des profils ; il doit donc être considéré comme en lecture seule
- Pour les modifications, il est recommandé de modifier le
Cargo.toml de chaque crate
Périmètre de la documentation
- Le guide utilisateur se trouve dans
crates/codegen/xai-grok-pager/docs/user-guide/
- La documentation couvre les sujets suivants
- Premiers pas
- Raccourcis clavier
- Commandes slash
- Configuration et thèmes
-
Serveurs MCP
- Skills et plugins
- Hooks
- Mode headless
- Sandboxing
Workflow de développement
- Comme la compilation de tout le workspace est lente, il est recommandé de toujours vérifier en ciblant des crates individuelles
cargo check -p <crate>
cargo test -p xai-grok-config
cargo clippy -p <crate>
cargo fmt --all
- Les tests et Clippy s’exécutent également crate par crate
- La configuration de Clippy se trouve dans
clippy.toml à la racine du dépôt, et celle du formatage Rust dans rustfmt.toml
Contributions et licence
- Le dépôt n’accepte pas les contributions externes
- Le code propre au dépôt est distribué sous Apache License 2.0
- Le code tiers et vendored conserve les licences de ses sources d’origine
THIRD-PARTY-NOTICES contient les avis relatifs aux dépendances crates.io et Git, aux thèmes d’interface groupés et aux ports internes présents dans l’arbre de sources
- Les ports internes incluent les implémentations d’outils de
openai/codex et sst/opencode
crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md contient le texte des licences des ports Codex et OpenCode ainsi que l’avis de modification Apache §4(b)
third_party/NOTICE fournit l’index des avis de la pile Mermaid vendored
1 commentaires
Avis sur Hacker News
J’ai aussi davantage documenté mon exploration du code de Grok sur mon blog : https://simonwillison.net/2026/Jul/15/grok-build/
[thedavidweng/gork-build][1] est un fork orienté confidentialité à la manière de VSCodium, qui remplace grok par « gork » et supprime la télémétrie fournisseur, la conservation des données activée par défaut et les mises à jour automatiques x.ai
[DigiGoon/digi-grok-build][2] est un CLI multi-fournisseur, « dgrok », qui se compile depuis les sources au lieu d’utiliser le CDN x.ai, et [victor-software-house/open-grok][3] prend en charge tous les fournisseurs
[LukaMucko/grok-build][4] ajoute
extra_bodypour les champs de requête propres aux fournisseurs, et [RapidAI/grok-build-desktop][5] ajoute une GUI desktop Tauri[mazdak/grok-build][6] fournit un thème Catppuccin, [thomas9120/grok-build-archival][7] un script de désactivation de la télémétrie Windows, et [saqoah/grok-build][8] un
MemoryBackendKotlin[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, mais ce n’est pas encore l’outil le plus stableCela dit, quand il fonctionne correctement, il est plutôt excellent, et à 10 dollars par mois, il est imbattable côté prix
La valorisation des entreprises auxquelles il est associé ne paraît pas rationnelle, et un échec complet face aux grandes entreprises d’IA pourrait suffire à déclencher l’effondrement
Après vérification, les abonnements de la gamme X Premium donnent aussi accès à Grok Build et prennent officiellement en charge plusieurs environnements d’exécution tiers
opencode. J’essaie de voir vers quelles solutions ouvertes les gens se tournent. Codex est aussi semi-ouvert, même si les contributions sont fermées, et il est plutôt bonompou Claude Code, sans que je sache exactement pourquoi. Après avoir désactivé l’upload du code, il ne répond plus instantanément en quelques millisecondes comme avant