Desktop control plane for Grok Build.
Screenshot · Features · Quick start · Architecture · Roadmap
A desktop GUI for Grok Build — multi-session task board, live timeline, workspace browser, permission management, and usage dashboard. Attaches to grok over ACP (Agent Client Protocol) via stdio; it does not run its own agent loop.
Tauri 2 · React 19 · TypeScript · Rust · current version 0.2.4
| Area | Behavior |
|---|---|
| Tasks | Multi-session board: sessions under ~/.grok (%USERPROFILE%\.grok on Windows). Create, select, prompt, and stop tasks. First send auto-connects via ACP. |
| Timeline | Unified stream of user messages, agent responses, thoughts, tool calls, shell output, plans, and events. Live ACP when connected; disk-hydrated from updates.jsonl otherwise. Filter chips + auto-scroll. |
| File changes | Agent file-hunk display from hunk_records.jsonl. |
| Workspace | Project file tree and Git porcelain status in a side panel. Supports file preview (text, images, binary detection). |
| Mode | Grok parity ring: Normal → Plan → Auto → Always-approve. Plan is orthogonal to permission mode — the next user message becomes /plan …. When the agent calls exit_plan_mode, a review panel appears (Approve / Request changes / Quit). Mode changes only affect the host ACP gate. |
| Permissions | Five-level gate: Default (ask), Accept edits, Auto (risk-classified), Bypass permissions, Don't ask. Per-task preferences persisted in ~/.pinkcode/task_prefs.json. Handles reverse RPCs: tool permission, file write, plan approval, and user questions. |
| Usage | Weekly credit usage (Grok billing API) with per-product breakdown, plus 7-day token usage series derived from session logs. |
| Updates | Auto-checks GitHub Releases on startup with optional one-click install. |
Prebuilt installers: Releases (Windows x64 NSIS, macOS Apple Silicon & Intel). Linux: build from source (no CI installer yet).
PinkCode attaches to Grok Build over ACP — install the CLI before running PinkCode.
Windows (PowerShell):
irm https://x.ai/cli/install.ps1 | iexmacOS / Linux / WSL:
curl -fsSL https://x.ai/cli/install.sh | bashAfter install, the grok binary and data live under ~/.grok (or %USERPROFILE%\.grok / GROK_HOME on Windows).
| macOS | Windows 11 | Linux | |
|---|---|---|---|
| Node | 24+ | 24+ | 24+ |
| Rust | stable | stable (x86_64-pc-windows-msvc) |
stable |
| Platform | Xcode CLT | MSVC Build Tools + WebView2 | webkit2gtk (see Tauri docs) |
| Grok Build | installed (step 1) | installed (step 1) | installed (step 1) |
Windows toolchain (once):
winget install Microsoft.VisualStudio.2022.BuildTools --override "--wait --passive --norestart --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended"powershell -ExecutionPolicy Bypass -File scripts/windows-setup.ps1npm install
npm run tauri:dev # development
npm run tauri:build # local installer under src-tauri/target/release/bundle/
npm run check # frontend + Rust (fmt/clippy/test) — same as CIEnv (optional)
| Variable | Meaning |
|---|---|
GROK_BIN |
Path to grok / grok.exe |
GROK_HOME |
Grok data root (default ~/.grok) |
PINKCODE_HOME |
PinkCode prefs root (default ~/.pinkcode) |
UI (React 19 + TypeScript)
|-- invoke() --> Tauri IPC (30 commands)
| sessions, agent lifecycle, permissions,
| billing, workspace FS, git status
|-- listen() <-- Tauri events (7 channels)
agent-update | agent-status | agent-permission
| agent-shell | agent-prompt-complete | sessions-changed
|
|-- AgentManager — N x `grok agent stdio` (ACP) + host permission gate
|-- Session index — FS watcher on ~/.grok/sessions (cards, hunks, stats)
|-- Billing — HTTP calls to Grok billing API (OIDC auth via ~/.grok/auth.json)
PinkCode communicates with Grok Build over ACP (JSON-RPC over stdio). The host-side permission gate intercepts reverse RPCs (session/request_permission, fs/write_text_file, x.ai/exit_plan_mode, x.ai/ask_user_question) and applies the configured risk policy before allowing or denying agent actions.
Copyright (c) 2026 3xian. All rights reserved. Published without an open-source license.