开源 Grok App

---

[!NOTE] About Grok App: Grok App is an open-source desktop client and workbench for the local Grok Build CLI (grok agent stdio). It is not an official xAI product. The application does not bundle proprietary model backends; all chat reasoning, tool execution, and permissions run directly through your installed grok CLI.

Full agent capabilities require an installed and signed-in Grok Build CLI. The first-run setup wizard can assist with CLI installation, and UI-only development can be run with GROK_APP_ACP=mock.

---

Contents

• ✨ Key Highlights
• 🛠️ Features Overview
• 📸 Screenshots
• 🚀 Quick Start & Installation
• 💡 Platform Notes & Troubleshooting
• 📂 Configuration & Data Paths
• 💻 Building from Source & Development
• 🤝 Community & Contributing
• 👥 Contributors
• 📄 License & Author

---

✨ Key Highlights

• ⚡ Native Build Sessions — Deep integration with grok agent stdio via the ACP protocol. Granular permission tiers (Ask, Allow Once, Allow for Session, and YOLO mode) with Grok 4.7 Extra High (xhigh) enabled by default. Grok 4.7 Fast is also selectable.
• 🗂️ Multi-Project Workbench — Isolated project workspaces, agent status Kanban, one-click Git Worktree switching, session forking from any assistant reply, and cross-session context attachment.
• 📝 Files & Creation Loop — Embedded CodeMirror 6 editor with instant disk synchronization, visual Git Diff review, comprehensive media preview (images, video, audio, PDF, Office documents), and AI image/video generation via Imagine.
• 📲 Omnichannel Remote IM — Unified bridge connecting your local agent to Feishu/Lark, Telegram, Discord, Slack, DingTalk, WeCom, WeChat personal, QQ, Matrix, LINE, and Weibo; token-gated mobile web mirror and loopback REST session API.
• 🐾 Desktop Companion & Status Feedback — Interactive always-on-top desktop pet companion with live agent status awareness, responsive reactions, and notification bubbles.
• 🔐 Privacy & Custom Relays — API keys securely stored in your OS keychain. SuperGrok quota bar and heatmap tracking, custom provider relays (OpenRouter, Requesty, DeepSeek, AI98PRO, etc.), and 15 built-in UI languages.

---

🛠️ Features Overview

1. Modern Workbench & Session Management

• Projects & Workspaces: Folder trust system, workspace isolation, virtualized high-performance sidebar, chat archiving, cross-project migration, and CLI session import.
• Parallel Workflows: Multi-session concurrent execution with continuous background streaming; intelligent process management and idle resource recycling; Kanban board (Needs Input / Working / Done).
• Git Worktree Integration: Automatically discovers linked Git worktrees for seamless working directory switching within sessions.
• Session Forking & Attachment: Branch off from any assistant turn with aligned context history; attach up to 3 reference sessions via /attach-chat or drag-and-drop.

2. Agent Interaction & Live Streaming

• Structured Timeline: Thought reasoning, tool executions, and final responses streamed in real-time order with live activity indicators.
• Power Composer: Queue follow-up prompts while the agent is busy; Ctrl+Enter to steer the active turn; type-to-focus; prompt history; selection quotes and inline annotations.
• Granular Permissions: Interactive Ask confirmation by default; allow once, allow for session, per-project defaults, or unattended YOLO mode; workspace sandbox support.
• Plan & Goal Tracking: Sticky multi-step plan progress with full Markdown execution details and structured milestones in the resources panel.

3. Files, Media & Creation Center

• In-App Code & Text Editor: CodeMirror 6 multi-tab editor with live two-way file synchronization and instant disk reload after agent modifications.
• Visual Changes & Diffs: Inspect session modifications and workspace Git diffs with granular single-file or batch accept/reject/revert controls.
• Rich Media Viewer: Native rendering and preview for images, video, audio, PDF, and Word/Excel/PowerPoint documents; high-quality share-card image export.
• AI Asset Generation: Generate images and videos directly from the composer using the Imagine skill; integrated side-browser with Design Mode for local web development previews.

4. Extensions, Plugins & Automations

• Slash Commands & Skills: Fully aligned with Grok Build slash command palette, inline skill chips, and custom automated workflows (/workflow).
• Extensions Hub: Manage Model Context Protocol (MCP) servers, plugins catalog (OpenAI plugin compatible), skills, agents, and hooks with full user control.
• ChatCut Integration: Native integration for the recommended Codex plugin with automated OAuth refresh and external editor workflows.
• Scheduled Automations: Schedule recurring or one-off tasks with natural-language prompt creation and visual execution logs.

5. Remote Connectivity & Cross-Device Access

• 11+ IM Channel Bridges: Connect to your preferred messaging apps to monitor, resume, and steer your local desktop agent on the go (/p project switch, /r resume).
• Mobile Web Mirror: Lightweight token-gated web app for mobile browsers; compatible with Cloudflare Quick Tunnel for secure remote access.
• Local Session API: Loopback REST endpoints (GET /v1/sessions, POST /v1/sessions/{id}/turns) for scripting, CI, or third-party tool integrations.

This is the beginning of the README. Read the rest at the original. Read the full README ↗