RongleCat GitHub avatar

grok-app

RongleCat

Grok App is a desktop command center built with Tauri 2 that wraps the local Grok Build CLI into a graphical workbench for managing sessions, projects, media, automations, and accounts.

Stars

356

7-day growth

+255

Forks

38

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It addresses the lack of a dedicated desktop interface for the Grok CLI, offering a structured way to handle multiple projects, permission controls, rich media previews, scheduled tasks, and bilingual UI, all while being unofficial and open-source.

Who it is for

  • Developers and power users of xAI's Grok Build CLI
  • AI agents/makers who need a desktop GUI to manage multiple CLI sessions
  • Open-source contributors interested in Tauri 2 + React tooling
  • Grok users who prefer a visual interface over terminal commands

Use cases

  • Managing multiple Grok CLI sessions with per-project trust directories and orphan sessions
  • Handling permission prompts (Ask/Allow once/session/Deny/YOLO) when interacting with agents
  • Previewing images, videos, PDFs, Office documents, and code files generated by agents
  • Scheduling automations directly from conversation with natural language and viewing the task list

Strengths

  • Cross-platform support (macOS ARM/Intel, Windows x64) with GitHub Actions CI builds
  • Built on modern stack (Tauri 2 + Rust, React + TypeScript + Vite, Tailwind CSS)
  • Provides a setup wizard, custom GROK_HOME configuration, and isolation from default CLI config
  • Includes i18n with Chinese/English toggle and a wide range of features besides chat (media, automations, account heatmap)

Considerations

  • Not an official xAI product; requires a locally installed and logged-in Grok Build CLI for full functionality
  • macOS releases are not notarized, causing Gatekeeper warnings that require manual xattr removal
  • Relatively early-stage (based on 'note: unofficial' tag) and may have limited documentation for non-Chinese audiences

README quick start

Grok App

Desktop workbench for local Grok Build Sessions, projects, media, automations — for the real grok CLI

English · 中文

Follow the author X / Twitter → 铁柱AGI @cgnot996 WeChat Official Account: search 「铁柱AGI」 (scan or WeChat Search below)

Repo · RongleCat/grok-app

[!NOTE]

Note

Grok App is not an official xAI product. It wraps the local Grok Build CLI (grok agent stdio) into a desktop workbench: sessions, projects, permissions, media previews, and scheduled tasks.

Real agent power needs a working Grok Build CLI installed and signed in. Without CLI you can install from the first-run wizard, or use GROK_APP_ACP=mock for UI-only development.

Contents

  1. Overview
  2. Features
  3. Screenshots
  4. Install & first run
  5. macOS “damaged” / Gatekeeper
  6. Config paths
  7. Develop & build
  8. Docs & contributing
  9. Contributors
  10. Follow the author

Overview

The grok CLI is powerful in a terminal. Day-to-day work still needs multi-project sessions, a permission bar, rich previews, scheduled jobs, and bilingual UI.

Grok App is that workbench:

  1. Install the app and prepare Grok Build CLI
  2. Add a project / new session
  3. Connect the agent; chat under Ask or YOLO
  4. Preview artifacts, schedule automations, manage account & relays in Settings

Stack: Tauri 2 + Rust · React + TypeScript + Vite · Tailwind CSS

Features

AreaWhat you get
Real Build sessionsDefault grok agent stdio (ACP); host-owned session FSM; optional remote ACP
Projects & sessionsTrusted dirs, virtualized sidebar, archive / orphan, fork & rewind; import CLI sessions in shared mode
Multi-session streamKeep busy turns streaming after switching chats; process limits & idle recycle
Git worktreesProject chip lists linked worktrees; switch cwd in one click (hidden for non-git)
PermissionsDefault Ask; allow once / session / deny; YOLO; per-project permission tier
Plan / GoalSticky execution progress; resource-pane Markdown review + steps; Goal entry
**Slash · Extens

Description

Desktop workbench for Grok Build CLI — sessions, projects, media, automations (Tauri 2 · unofficial)

Related repositories

Similar projects matched by category, topics, and programming language.

l0ng-ai
Featured
l0ng-ai GitHub avatar

tty7

tty7 is a fast, GPU-accelerated terminal workbench with persistent sessions, built-in input tools, SSH support, and coding agent awareness.

Developer ToolsCLI & Terminal
359
programmersd21
Featured
programmersd21 GitHub avatar

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal
277
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20