Grok Build

xai-org/grok-build — SpaceXAI のターミナル AI コーディングエージェント（grok）

xai-org/grok-build は SpaceXAI のフルスクリーン TUI コーディングエージェント。コードベース理解・ファイル編集・シェル実行・Web 検索・長時間タスクを、対話 TUI / headless（CI・スクリプト）/ ACP（エディタ埋め込み）で扱う。製品サイトは x.ai/cli。公開ツリーは社内モノレポから定期同期。

TUI
対話 UI
-p
headless
ACP
agent stdio
Rust
workspace
ライセンス / 貢献: 第一当事者コードは Apache-2.0。外部 PR は受け付けない（透明性とローカルビルド用の公開）。脆弱性は SECURITY.md の手順で報告。
実行モード
3 つの入口
Interactive TUI
既定起動。スクロールバック・プロンプト・モーダル。初回はブラウザ認証。
Headless
grok -p "…"（または --prompt-json / --prompt-file）。stdout に結果、終了コードで完了。出力は plain / json / streaming-json。
Agent mode (ACP)
grok agent stdio。JSON-RPC でセッション・プロンプト・ツール可視化・権限承認。Zed / Neovim 等との統合。
grok --version
grok -p "Summarize this repo"
grok agent --model grok-build stdio
機能マップ
ユーザーガイド（pager crate 同梱）

オンライン正本: docs.x.ai/build/overview。リポジトリ内は crates/codegen/xai-grok-pager/docs/user-guide/。

領域章（例）内容
導入01–06インストール、認証、ショートカット、スラッシュコマンド、設定、テーマ
拡張07–12MCP、skills、plugins、hooks、custom models、project rules
ランタイム13–17memory、headless、ACP、subagents、sessions
安全・運用18–24sandbox、plan mode、background tasks、permissions、dashboard、usage
Agent 定義

xai-grok-agent は Markdown + YAML frontmatter のエージェント定義を .grok/agents/（プロジェクト）または ~/.grok/agents/（ユーザー）から読み、ツール集合・システムプロンプト・compaction / model 設定を束ねる。

リポジトリ構成
主要クレート 
flowchart TD
  BIN[xai-grok-pager-bin] --> PAGER[xai-grok-pager TUI]
  BIN --> SHELL[xai-grok-shell runtime]
  SHELL --> AGENT[xai-grok-agent]
  SHELL --> TOOLS[xai-grok-tools]
  SHELL --> WS[xai-grok-workspace]
  SHELL --> MCP[xai-grok-mcp]
  PAGER --> MD[xai-grok-markdown]
  SHELL --> SBX[xai-grok-sandbox]
  COMMON[crates/common + build] --> SHELL
  TP[third_party Mermaid stack] --> PAGER
パス役割
xai-grok-pager-bin合成ルート。バイナリ名は xai-grok-pager（配布名 grok）
xai-grok-pagerTUI（scrollback / prompt / modals / render）
xai-grok-shellエージェントランタイム、leader / stdio / headless 入口
xai-grok-tools端末・編集・検索などのツール実装
xai-grok-workspaceFS / VCS / 実行 / チェックポイント
crates/common/ · build/ · prod/mc/共有リーフ
third_party/Vendored Mermaid 系
注意: ルート Cargo.toml は生成物。ワークスペース編集は各クレートの Cargo.toml 側で行う。
インストール
リリースバイナリ 
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

changelog: x.ai/build/changelog。特定版は install スクリプトに版番号を渡すか、GROK_VERSION（PowerShell）を指定。

ソースビルド
要件とコマンド
  • Rust — rust-toolchain.toml（channel 1.92.0）。rustup が自動導入。
  • protoc — bin/protoc（dotslash）または PATH / $PROTOC。
  • ビルドホストは macOS / Linux。Windows はこのツリーからは best-effort。
cargo run -p xai-grok-pager-bin              # build + launch TUI
cargo build -p xai-grok-pager-bin --release  # target/release/xai-grok-pager
cargo check -p xai-grok-pager-bin
cargo test -p xai-grok-config                # クレート単位
cargo clippy -p <crate>
cargo fmt --all

フルワークスペースビルドは遅いので、常に -p <crate> を付ける（README）。

公式