Grok Build Studio

Unofficial third-party desktop client for Grok Build.
Not affiliated with, endorsed by, or maintained by xAI.
Grok and related marks belong to their respective owners.

Local-first, cross-platform, auditable GUI for the Grok Build CLI. It drives grok agent stdio over ACP JSON-RPC instead of wrapping the TUI or reimplementing the agent.

Architecture

Vue 3 Desktop UI
        │  Typed Tauri IPC
        ▼
Rust Application Core
        │  ACP JSON-RPC / stdio
        ▼
grok agent stdio

Tech stack

Layer	Stack
Desktop	Tauri 2
Frontend	Vue 3, TypeScript, Vite, Pinia, Vue Router, Element Plus
Backend	Rust, Tokio, Serde
Protocol	ACP (stable core + optional x.ai/* extensions)
Storage	SQLite (UI index / event projection only)

Prerequisites

• Node.js 22+ and pnpm
• Rust stable (1.77+)
• Platform WebView / build tooling per Tauri prerequisites
• Optional for live agent features: Grok Build CLI installed and authenticated

Develop

pnpm install
pnpm tauri dev

Quality gates

pnpm lint
pnpm test
pnpm build
cargo fmt --check --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml

Security baseline

• Main window capabilities exclude general shell spawn
• Frontend never starts processes or reads auth token files
• Default permission mode is Ask; GUI cannot bypass Grok policy
• See SECURITY.md

Project status

Implementation follows grok_build_cli_gui_research_and_implementation_plan.md and is tracked in TASKS.md.

Current focus: Milestone 0 (scaffold + typed IPC) → Milestone 1 (runtime discovery + ACP transport).

License

MIT — see LICENSE.