プログラミング
Grok Build
要約
Grok BuildはSpaceXAIが開発したターミナルベースのAIコーディングエージェントです。コードベースを理解し、ファイルの編集、シェルコマンドの実行、Web検索、タスク管理などを対話式またはスクリプト実行で可能にします。Rustで書かれており、macOS、Linux、Windows向けのバイナリが提供されています。
全文翻訳
Grok Build (grok)
Grok BuildはSpaceXAIのターミナルベースのAIコーディングエージェントです。コードベースを理解し、ファイルを編集し、シェルコマンドを実行し、Webを検索し、長時間実行されるタスクを管理するフルスクリーンTUIとして動作します。対話式、スクリプト/CIのためのヘッドレスモード、またはAgent Client Protocol (ACP)を介したエディタへの埋め込みが可能です。
リリース済みバイナリのインストール
ソースからのビルド
ドキュメント
リポジトリレイアウト
開発
コントリビューティング
ライセンス
Grok Buildの詳細については x.ai/cli を参照してください。
このリポジトリには、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 (dotslashランチャー) を解決するか、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クレートに含まれています: 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クレートクロージャの残りの部分 (設定、MCP、markdown、サンドボックスなど)。
crates/common/, crates/build/, prod/mc/
クロージャによってプルインされる小さな共有リーフクレート。
third_party/
ベンダーされたアップストリームソース (Mermaidダイアグラムスタック) — 以下を参照。
重要: ルートのCargo.toml (ワークスペースメンバー、依存関係バージョン、lint、プロファイル) は生成されるため、読み取り専用として扱ってください。クレートごとのCargo.tomlファイルを編集することを推奨します。
開発
cargo check -p <crate> # 常にターゲットクレートを指定。フルワークスペースビルドは遅いです。
cargo test -p xai-grok-config # クレートごとのテスト。
cargo clippy -p <crate> # lint 設定: リポジトリルートのclippy.toml。
cargo fmt --all # リポジトリルートのrustfmt.toml。
コントリビューティング
注意: 外部からのコントリビューションは受け付けられません。CONTRIBUTING.md を参照してください。
ライセンス
このリポジトリ内のファーストパーティコードはApache License, Version 2.0の下でライセンスされています。LICENSE を参照してください。
サードパーティおよびベンダーされたコードは、元のライセンスの下で引き続きライセンスされています。
参照: THIRD-PARTY-NOTICES — crates.io / git依存関係、バンドルされたUIテーマ、およびツリー内ソースポート (openai/codexおよびsst/opencodeツール実装を含む)。
crates/codegen/xai-grok-tools/THIRD_PARTY_NOTICES.md — codexおよびopencodeポートのクレートローカル通知 (ライセンステキスト + Apache §4(b) 変更通知)。
third_party/NOTICE — ベンダーされたMermaidスタックインデックス。