Delegate outcomes, not terminal commands. A native macOS GUI for Grok Build — projects, tasks, scheduled jobs, and full agentic delegation in one desktop workspace.
Community project. Not affiliated with xAI. See DISCLAIMER.md.
Download: Latest release (DMG) · Docs: Install guide · Verify: verify-setup.sh
Full workspace — delegate outcomes with per-task progress, folders, and connectors.
Scheduled tasks — recurring jobs with their own detail view and run output.
Sidebar & panels — projects, tasks, progress checklist, and working-folder context at a glance.
Reduce everything on your computer to executive functions. You decide what needs done. Grok handles how.
Grok Executive Suite wraps Grok Build's full agentic power — projects, resumable tasks, scheduled jobs, working-folder context, connectors, progress tracking, and autonomy controls — in a desktop workspace built for people who prefer GUIs over shells.
- Projects — scoped workspaces with root path + working folders
- Tasks — persistent, resumable conversation threads per project
- Scheduled tasks — cron jobs with isolated run history and unread indicators
- Progress — per-task checklist synced via Grok's
update_goaltool - Working folders — directories injected into every Grok prompt
- Connectors — tools/MCPs used in each session (auto-tracked)
- Act without asking — toggles
--always-approvefor full autonomy - Desktop control — mouse, keyboard, and app focus via bundled MCP server
- Desktop capture — screenshot attach via menu or drag-and-drop
- Message queue — type while Grok runs; sends when done
- Spellcheck — native macOS spelling suggestions in the prompt
| Requirement | Details |
|---|---|
| Mac | Apple Silicon (M1/M2/M3/M4) |
| macOS | 13 Ventura or newer (recommended) |
| Subscription | SuperGrok or X Premium Plus |
| Grok Build CLI | Installed at ~/.grok/bin/grok |
Verify your system before installing:
curl -fsSL https://raw.githubusercontent.com/Printerpilot/grok-executive-suite/main/scripts/verify-setup.sh | bashOr clone the repo and run:
npm run verifycurl -fsSL https://x.ai/cli/install.sh | bashConfirm it works:
~/.grok/bin/grok --versionSign in with your xAI account when prompted.
- Go to GitHub Releases
- Download
Grok Executive Suite-0.3.3-arm64.dmg - Open the DMG and drag Grok Executive Suite.app to Applications
macOS may block the first open because the build is not notarized:
- Right-click the app → Open → confirm, or
- System Settings → Privacy & Security → allow anyway
- Launch Grok Executive Suite
- Click + New Project and pick any folder
- Type what you need done in the chat — e.g. "Review this repo and list the top 3 priorities"
- Optional: add Working folders, create Scheduled tasks, toggle Act without asking
If Grok Build is missing, an orange banner at the top explains how to install it.
Grok Executive Suite delegates to Grok Build for agent work. Most capabilities are built into Grok Build (shell, filesystem, web search, subagents, skills). Desktop mouse/keyboard control requires a one-time setup.
Quick setup (recommended):
# From a repo clone (or after cloning for setup only):
git clone https://github.com/Printerpilot/grok-executive-suite.git
cd grok-executive-suite
npm run setup:parity
npm run verify:fullOr without cloning:
curl -fsSL https://raw.githubusercontent.com/Printerpilot/grok-executive-suite/main/scripts/setup-grok-parity.sh | bashWhat setup:parity installs:
| Component | Purpose |
|---|---|
executive-suite-desktop MCP |
Mouse, keyboard, app open/focus tools for Grok Build |
Recommended ~/.grok/config.toml |
permission_mode = "always-approve" for CLI parity |
MCP server at ~/.grok-cowork/mcp/ |
Stable path for DMG-only users |
macOS permissions (System Settings → Privacy & Security):
| Permission | Needed for |
|---|---|
| Accessibility | Grok Executive Suite + Terminal (desktop mouse/keyboard) |
| Screen Recording | Desktop screenshot capture (menu → Capture Desktop) |
In the app: toggle Act without asking ON — passes --always-approve to Grok on every task.
Built-in (no extra install): Shell, filesystem read/write, web search, update_goal, subagents, skills — these come with Grok Build + your subscription.
Optional MCP servers: Add your own via grok mcp add (GitHub, databases, etc.). The app auto-tracks connectors used per task.
Developers: this repo also ships .grok/config.toml (project-scoped MCP) so grok run with --cwd pointing here loads desktop control automatically.
All state lives locally at:
~/.grok-cowork/
├── state.json # projects, scheduled tasks, settings
└── projects/
└── <project-id>/
├── manifest.json # tasks, progress, connectors
└── <task-id>/
├── chat.jsonl
└── attachments/
Your projects, tasks, and chat history survive app restarts.
git clone https://github.com/Printerpilot/grok-executive-suite.git
cd grok-executive-suite
npm install
npm run verify # checks Grok CLI + Apple Silicon
npm run setup:parity # register desktop MCP + recommended Grok config
npm run verify:full # verify + MCP + desktop control smoke test
npm start # development
npm run dist # produces dist/Grok Executive Suite-<version>-arm64.dmg./install-update.sh| Layer | Role |
|---|---|
renderer/index.html |
UI (Electron renderer) |
main.js |
IPC, Grok process spawn, cron, persistence |
preload.js |
Secure bridge to renderer |
lib/task-store.js |
Per-project task/chat persistence |
lib/session-tracker.js |
Connector backfill from Grok session events |
Grok is invoked as:
~/.grok/bin/grok -p "<prompt>" --output-format streaming-json --cwd <project-root> [--always-approve] [--resume <session>]
| Issue | Fix |
|---|---|
| Orange "Grok Build CLI not found" banner | Run curl -fsSL https://x.ai/cli/install.sh | bash |
| App won't open | Right-click → Open, or allow in Privacy & Security |
| Grok fails immediately | Ensure you're signed in; run ~/.grok/bin/grok in Terminal |
| Desktop control not working | Run npm run setup:parity; grant Accessibility to the app and Terminal |
| Desktop capture fails | Grant Screen Recording to Grok Executive Suite |
| MCP not listed | Run ~/.grok/bin/grok mcp list; re-run npm run setup:parity |
| Scheduled task shows in main chat | Update to v0.3.0+ — runs are isolated to task details |
| Spellcheck not working | Restart app; requires macOS spellchecker enabled |
MIT — see LICENSE.
Built by an enthusiastic Grok user who prefers GUIs to terminals. Thanks to Elon and the xAI team for Grok Build and the innovation they bring to builders worldwide.