RongleCat/grok-app

Open-source Grok App — desktop workbench (GUI) for the local Grok Build CLI: sessions, projects, media, automations. Tauri 2.

Grok App – Desktop Workbench for the Local Grok Build CLI

What it is – An open‑source, cross‑platform desktop client (built with Tauri 2) that lets you run the local grok command‑line agent (the “Grok Build” CLI from xAI) inside a rich graphical workbench. It does not ship any proprietary model; all LLM reasoning, tool use and permission handling happen through the user‑installed grok binary.

Core capabilities (as described in the README)

Area	What you get
Session & project management	Isolated workspaces, Kanban‑style status board, Git worktree switching, ability to fork a session from any assistant turn, and attach up to three reference sessions.
Live agent interaction	Real‑time streaming of the agent’s thoughts, tool executions and final answer; granular permission prompts (Ask, Allow‑once, Allow‑session, YOLO); a “Power Composer” for queuing follow‑ups while the agent is busy.
File & media loop	Integrated CodeMirror 6 editor that syncs instantly with disk, visual Git diffs, preview of images, video, audio, PDFs and Office docs, plus AI image/video generation via the built‑in Imagine skill.
Omnichannel IM bridge	Connect the local agent to 11+ messaging platforms (Feishu/Lark, Telegram, Discord, Slack, DingTalk, WeCom, WeChat, QQ, Matrix, LINE, Weibo) and a token‑gated mobile‑web mirror for remote control.
Desktop companion	Optional always‑on‑top “pet” that shows agent status and pushes notifications.
Privacy & relays	API keys stored in the OS keychain, support for custom provider relays (OpenRouter, DeepSeek, etc.), quota/heat‑map tracking for the official SuperGrok service.
Customization	Light/dark/system themes, custom skins, fonts, UI language (15 built‑in locales).

How you get started

Install the Grok Build CLI (grok ≥ 0.2.112). The app’s first‑run wizard can install it for you.
Download a pre‑built package for macOS, Windows or Linux from the website or GitHub releases. No Node.js or Rust runtime is needed for the binary.
Run the app, follow the setup wizard to link the CLI (or use the mock backend with GROK_APP_ACP=mock for UI‑only development).
Create a project, trust the folder, and start a session – the UI will stream the agent’s output and let you edit files directly.

Technical notes (useful for power users)

Built with Tauri 2 – lightweight native wrapper around a Vite‑powered web UI.
ACP protocol – the app talks to grok agent stdio via the Agent Communication Protocol, enabling fine‑grained permission handling.
Cross‑platform quirks – macOS notarized, Windows may need SmartScreen bypass, Linux AppImage requires host libEGL.so.1 and WebKitGTK 4.1 (or use the .deb/.rpm).
Development – pnpm + Rust toolchain; pnpm dev runs the full desktop with hot‑reload, GROK_APP_ACP=mock pnpm dev skips the CLI.

Who might find it useful?

Developers who already use the Grok Build CLI locally and want a GUI to manage multiple projects, view file changes, and keep a history of agent sessions.
Teams that need a consistent desktop environment for AI‑assisted coding, content creation, or data‑analysis while keeping all data on‑premises.
Power users who want to bridge their local agent to external messaging platforms or automate tasks via the built‑in REST session API.

All information above is taken directly from the repository’s README; no additional features are inferred.