Grok构建是SpaceXAI的基于终端的AI编码代理。它作为一个全屏TUI运行，可以理解您的代码库，编辑文件，执行Shell命令，搜索网络，并管理长时间运行的任务—可交互地、无头地用于脚本/CI，或通过代理客户端协议（ACP）嵌入编辑器中。安装发布的二进制文件 · 从源代码构建 · 文档 · 仓库布局 · 开发 · 贡献 · 许可证 在x.ai/cli了解更多关于Grok构建的信息。本仓库包含grok CLI/TUI及其代理运行时的Rust源代码。它定期从SpaceXAI单一代码库同步更新。安装发布的二进制文件 为macOS、Linux和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 查看变更日志以获取每个版本的最新修复、功能和改进。 从源代码构建 要求：Rust—工具链由rust-toolchain.toml固定；rustup会在首次构建时自动安装它。protoc—proto代码生成解析bin/protoc（一个dot-slash启动器）或回退到PATH / $PROTOC上的protoc。 macOS和Linux是支持的构建主机；Windows构建是尽力而为，目前未在此树中进行测试。 cargo run -p xai-grok-pager-bin # 构建 + 启动TUI cargo build -p xai-grok-pager-bin --release # 发布二进制文件：target/release/xai-grok-pager cargo check -p xai-grok-pager-bin # 快速验证 二进制产物命名为xai-grok-pager；正式安装将其作为grok发布。首次启动时，它会打开您的浏览器进行验证—请参阅身份验证指南。 文档 完整的在线文档可在docs.x.ai/build/overview上获得。用户指南与pager crate一起发布：crates/codegen/xai-grok-pager/docs/user-guide/ — 入门、键盘快捷键、斜杠命令、配置、主题、MCP服务器、技能、插件、钩子、无头模式、沙盒等。 仓库布局 路径 内容 crates/codegen/xai-grok-pager-bin 组合根包；构建xai-grok-pager二进制文件 crates/codegen/xai-grok-pager TUI：滚动、提示、模态、渲染 crates/codegen/xai-grok-shell 代理运行时 + 领导者/stdio/无头入口点 crates/codegen/xai-grok-tools 工具实现（终端、文件编辑、搜索等） crates/codegen/xai-grok-workspace 主文件系统，VCS，执行，检查点 crates/codegen/... CLI crate闭包的其余部分（配置、MCP、markdown、沙盒等） crates/common/，crates/build/，prod/mc/ 由闭包拉入的小型共享叶子crate third_party/ 供应的上游源（Mermaid图堆栈） — 请参见下文 重要提示 根Cargo.toml（工作区成员、依赖版本、lint、配置文件）已生成—将其视为只读。更改时请优先编辑每个crate的Cargo.toml文件。 开发 cargo check -p < crate > # 始终针对特定的crate；全工作区构建较慢 cargo test -p xai-grok-config # 每个crate的测试 cargo clippy -p < crate > # lint配置：在根目录的clippy.toml cargo fmt --all # 在根目录的rustfmt.toml 贡献 许可证 本仓库中第一方代码根据Apache许可第2.0版获得许可 — 请参阅LICENSE。第三方和供应的代码仍然保留在其原始许可下。请参见：THIRD-PARTY-NOTICES — crates.io / git依赖关系，捆绑的UI主题，以及内部源端口（包括openai/codex和sst/opencode工具实现） crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md — crate本地通知，涉及codex和opencode端口（许可证文本 + Apache §4(b)变更通知） third_party/NOTICE — 供应的Mermaid堆栈索引