Grok UI——Grok Build 的可观测·可审批·可追溯本地指挥舱

📝

Grok UI 不是模型代理或聊天壳，而是一个非官方、本地优先的 Grok Build 指挥舱——9 个界面覆盖运行时监控、ACP 控制、Git 变更追踪、会话档案和复盘，把 Agent 从黑箱变成可观测的工程流水线。

AI Agent 一旦并行跑起来，难点往往不再是写代码，而是弄清谁还在工作、是否等审批、改了什么，以及旧会话怎样安全接着跑。

Grok UI 不是模型代理或聊天壳，而是一个非官方、单用户、本地优先的 Grok Build 指挥舱：读取真实运行记录，通过 ACP 控制会话，并把 Git 变更放进同一浏览器。

GitHub：joeynyc/Grok-UI（44 ⭐，TypeScript，v0.6.0，创建于 2026-07-24）

🏗️ 九个界面，覆盖从观察到复盘

界面	功能
Live	实时运行时状态——每 2 秒复查 PID，展示 working/waiting/idle/needs input，phase/工具、turns、context、cost
Control	原生 ACP 控制台——新建 Agent、选模型与 reasoning 级别、加载历史会话、managed lanes 并行显示
Changes	实时 Git 工作台——branch、ahead/behind、staged/unstaged/untracked、按路径过滤 patch
Overview	全局仪表盘——14 天趋势、工具、模型、工作区和最近会话，”Derived Health”按错误/turns 推导
Sessions	本地会话档案——按标题/workspace/model/agent 搜索筛选，Timeline 合并实时、受管和磁盘事件
Activity	14 天运行画像——按天呈现 turns、tool calls、代码变化、errors
Library	能力索引——扫描 bundled/user skills、agent profiles、marketplace cache
Memory	记忆清单——按 global/workspace/session 展示文件名、时间、体积
Themes	视觉系统——Operator（黑绿 HUD）、Event Horizon（深空红玻璃面板）

🔌 架构：四条数据路径，一台本地监督器

中心是 Express 5 本地 supervisor，前端为 React 19，浏览器用认证 API 写入，SSE 推送实时数据：

平面	职责
Runtime plane	读取活动进程表，tail `events.jsonl`/`updates.jsonl`
Control plane	启动 `grok agent --no-leader stdio`，通过 TypeScript ACP SDK 管理会话生命周期
Workspace plane	用 `execFile` 分离参数执行 Git，仓库须来自已知会话
Durable UI state	原子写入 `~/.grok-ui/state.json`，改名/归档可逆

🚀 最省时间的使用路径

# 预检
npx --yes grok-ui doctor

# 启动（默认 localhost:4310）
npx --yes grok-ui

# 多配置隔离
npx --yes grok-ui \
  --grok-home /path/to/.grok \
  --state-dir /path/to/.grok-ui \
  --port 4311 --no-open

使用建议：

Live 扫状态和 attention
Control 发起并行任务，敏感操作集中到 Approval queue
Changes 每轮结束前检查 patch
Workbench 继续旧会话、改名和归档
Overview/Activity 做复盘

🔒 隐私边界

默认 loopback 最安全，非本机绑定必须设 GROK_UI_TOKEN
Cookie HttpOnly、SameSite=Strict，响应禁缓存，无 analytics
Grok 凭据不进浏览器
远程访问应走 SSH 隧道/私有 VPN + TLS

💡 核心价值

Grok UI 的价值不是「美化终端」，而是把真实进程、结构化事件、ACP 审批、会话恢复和 Git 证据串成闭环。减少盯终端、切窗口和误判状态的成本。

GitHub 数据验证： 44 Stars · 7 Forks · TypeScript · MIT 协议

原文来源： 微信公众号「如此才是」（2026-07-25）