b-nnett/grok-bot-0.18-reconstructed

Unofficial source-oriented reconstruction and extension of Grok Bot 0.18.0 for macOS

What it solves

This project is a source-oriented reconstruction of the Grok Bot 0.18.0 macOS application. It allows users to understand the internal workings of the app and extends it with new capabilities, such as an inference router to switch between different AI providers and a local Docker sandbox for code execution.

How it works

The project uses a hybrid approach to rebuild the app. It reconstructs the runtime and control-plane code (Electron main, host, coordinator, and protocol) using readable TypeScript. It retains the original, minified production renderer (UI) from the shipped application to maintain the polished look and feel, applying only small, auditable patches to add new settings surfaces.

Who it’s for

This is a research and hacking project aimed at developers and researchers interested in reverse-engineering AI desktop applications and extending their functionality.

Highlights

  • Inference Router: Support for routing requests to Cursor, Claude Code, Codex, and OpenRouter, preserving streaming responses and MCP tool execution.
  • Local Docker Sandbox: An optional local containerized environment to replace the remote sandbox for tool execution.
  • Usage Tracking: Local recording of request and token totals for routed inference.
  • Deterministic Toolchain: A build system that downloads the pinned 0.18.0 app, verifies it, and assembles the reconstructed version.
  • MCP Tool Support: Integration of Grok Bot plugins and MCP tools across different routed providers.

Related

  • Dispatch
    Grok Build Open Source Release

    xAI has open-sourced Grok Build, a coding agent and terminal user interface (TUI) that supports local-first execution and an extensible extension system.

  • Project
    Jia-Ethan/grok-keysmith

    A deployment tool for Grok Build that safely manages the installation, verification, and removal of global custom instructions (home rules).

  • Project
    drawthingsai/draw-things-community

    A community repository providing the core image generation, sampling, and training code for the Draw Things app, including a self-hostable gRPC server for remote inference.

  • Project
    chenyme/grok2api

    Grok2API is an open‑source Go gateway with a React admin UI that aggregates multiple Grok Build, Grok Web, and Grok Console accounts into a single OpenAI‑/Anthropic‑compatible API. It handles credential sync, quota management, model discovery, routing, proxy‑rich egress, and media (image/video) endpoints, and can be run via Docker Compose or from source.

  • Project
    RongleCat/grok-app

    An open-source desktop workbench for the local Grok Build CLI that provides a visual interface for managing AI agent sessions, code editing, and remote IM connectivity.