# Grok Bot 0.18 Reconstructed Documentation

> Technical documentation for the unofficial Grok Bot 0.18 reconstruction: pinned bootstrap, reconstructed Electron/host/coordinator runtimes, inference routing, local Docker sandbox, and macOS packaging.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15)
- [GitHub repository](https://github.com/sashimikun/grok-bot-0.18-reconstructed)

## Repository

- Repository: sashimikun/grok-bot-0.18-reconstructed

- Generated: 2026-08-24T05:59:56.688Z
- Updated: 2026-08-24T06:02:19.192Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 26

## Pages

- [Overview](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/01-overview.md): What this reconstruction exposes, who can run it, the hybrid runtime split, and the first docs routes after clone.
- [Installation](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/02-installation.md): macOS Apple Silicon prerequisites, Node 26.5.x, Git LFS, Xcode tools, optional Docker, and npm ci.
- [Quickstart](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/03-quickstart.md): Clone, LFS pull, bootstrap, check, package, and open dist/Grok Bot 0.18 Reconstructed.app with the expected success signal.
- [Reconstruction boundary](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/04-reconstruction-boundary.md): Compiled source/ runtimes, checksum-pinned shipped renderer, reconstructed bundle id com.anysphere.sand.reconstructed, and ignored src/app/dist hydration.
- [Inference router](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/05-inference-router.md): SandInferenceProvider ids cursor, claude-code, codex, openrouter; default cursor; local transcript store schemaVersion 2; usage schemaVersion 1.
- [Box runtime](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/06-box-runtime.md): SandBoxRuntime remote versus local-docker, default remote, coordinator restart on switch, and loopback-only local gateway ownership.
- [Evidence and provenance](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/07-evidence-and-provenance.md): Pinned 0.18.0 DMG and app.asar SHA-256 identities, evidence-only UI rule, and production bindings that must resolve into source/.
- [Choose an inference provider](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/08-choose-an-inference-provider.md): Set Settings → Router, persist inferenceProvider, and satisfy Cursor session, Claude Code login, Codex auth.json, or OPENROUTER_API_KEY.
- [Enable the local Docker sandbox](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/09-enable-the-local-docker-sandbox.md): Toggle Use local Docker VM, start grok-bot-local-vm, wait for http://127.0.0.1:1340/health, and roll back to remote on start failure.
- [Route Grok Bot plugin tools](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/10-route-grok-bot-plugin-tools.md): listRoutedMcpTools and executeRoutedMcpTool across Claude Code MCP bridge versus Codex/OpenRouter direct tool execution.
- [Bootstrap the pinned runtime](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/11-bootstrap-the-pinned-runtime.md): npm run bootstrap order: GROK_BOT_018_APP, cached app, LFS DMG, then public URL; verify DMG and app.asar SHA-256; hydrate src/app/dist.
- [Package the macOS app](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/12-package-the-macos-app.md): npm run package compiles runtimes, patches Settings Router, replaces app.asar, sets reconstructed identity, ad-hoc signs, and verifies.
- [Work on the frontend reconstruction](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/13-work-on-the-frontend-reconstruction.md): frontend/ is a Vite design workspace; packaged UI stays the patched shipped renderer unless GROK_BOT_RENDERER_SOURCE overrides it.
- [npm scripts](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/14-npm-scripts.md): Exact package.json commands: bootstrap, check, package, verify, smoke, publication:check, frontend:build, and test globs.
- [Settings schema](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/15-settings-schema.md): settings.json version 1 fields: inferenceProvider, inferenceRouterUsage, boxRuntime, MCP instruction maps, and atomic persist path.
- [Environment variables](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/16-environment-variables.md): GROK_BOT_018_APP, GROK_BOT_OUTPUT_APP_NAME, SAND_DISABLE_*, OPENROUTER_API_KEY, SAND_OPENROUTER_MODEL, CODEX_HOME, CLAUDE_CODE_PATH, and binding-manifest overrides.
- [Desktop RPC](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/17-desktop-rpc.md): window.desktop.agent getInferenceRouter, setInferenceRouter, getBoxRuntime, setBoxRuntime, and secrets upsert/list channels.
- [Local Docker connector](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/18-local-docker-connector.md): Image, container name, owner label, schema version 6, loopback gateway URL, health probe, and content-addressed host-main.cjs mounts.
- [Provider clients](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/19-provider-clients.md): Cursor default path, Claude Agent SDK query, Codex Responses at chatgpt.com/backend-api/codex/responses, OpenRouter OpenAI-compatible model default openai/gpt-5.2.
- [Bootstrap failures](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/20-bootstrap-failures.md): LFS pointer-sized archives, DMG checksum mismatch, missing app.asar files, GROK_BOT_018_APP version mismatch, and hydration checksum errors.
- [Packaging failures](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/21-packaging-failures.md): Non-darwin package abort, missing renderer patch anchors, ad-hoc codesign retry, xattr quarantine, and verify required ASAR entries.
- [Router and sandbox failures](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/22-router-and-sandbox-failures.md): Unknown provider, Codex private auth.json, Claude Code not installed, missing OPENROUTER_API_KEY, and unowned grok-bot-local-vm container.
- [Verify and smoke](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/23-verify-and-smoke.md): npm run verify required ASAR paths and evidence markers; npm run smoke native e2e with 12s timeout; updater guard SAND_DISABLE_* defaults.
- [Preserve original installers](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/24-preserve-original-installers.md): Git LFS 0.18.0 macOS DMG and Windows setup.exe identities, artifacts.json schemaVersion 1, and shasum -c SHA256SUMS.
- [Publication export](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/25-publication-export.md): npm run publication:check archive/init/add tree equality, LFS push of installers, and NOTICE/rights review before a public remote.
- [Contributing](https://grok-wiki.com/public/docs/sashimikun-grok-bot-0-18-reconstructed-c774cc9a5c15/pages/26-contributing.md): Required check and package commands, no generated payloads in Git, do not weaken checksum or signing gates, private security reports.

## Source Files

- `CONTRIBUTING.md`
- `docs/ARCHITECTURE.md`
- `docs/PUBLISHING.md`
- `frontend/README.md`
- `frontend/src/recovered/features/settings/overlay/router.ts`
- `frontend/src/recovered/features/settings/overlay/view.tsx`
- `frontend/vite.config.ts`
- `manifests/reconstruction/electron-main-production-bindings-manifest.json`
- `NOTICE.md`
- `package.json`
- `PROVENANCE.md`
- `README.md`
- `research-archives/original/0.18.0/artifacts.json`
- `research-archives/original/0.18.0/SHA256SUMS`
- `research-archives/README.md`
- `scripts/apply-third-party-patches.mjs`
- `scripts/audit-ui-provenance.mjs`
- `scripts/bootstrap-runtime.mjs`
- `scripts/build-box-exec-daemon.mjs`
- `scripts/build.mjs`
- `scripts/clean-build.mjs`
- `scripts/lib/build-asar.mjs`
- `scripts/lib/codesign.mjs`
- `scripts/lib/config.mjs`
- `scripts/lib/macos-package-verification.mjs`
- `scripts/lib/router-renderer-patch.mjs`
- `scripts/lib/runtime.mjs`
- `scripts/lib/system-tools.mjs`
- `scripts/native-e2e-check.mjs`
- `scripts/package-macos.mjs`
- `scripts/recover-frontend.mjs`
- `scripts/smoke.mjs`
- `scripts/verify-publication-tree.mjs`
- `scripts/verify.mjs`
- `SECURITY.md`
- `source/box-exec-daemon/main.ts`
- `source/electron-main/box/box-host-connector.ts`
- `source/electron-main/box/local-docker-host-connector.ts`
- `source/electron-main/coordinator/coordinator-executors.ts`
- `source/electron-main/main-edge.ts`
- `source/electron-main/main.ts`
- `source/electron-main/secrets/secrets-ipc.ts`
- `source/electron-preload/main-rpc-runtime.ts`
- `source/electron-preload/preload.ts`
- `source/host/extensions/inference/codex-direct-responses.ts`
- `source/host/extensions/inference/cursor-session.ts`
- `source/host/extensions/inference/provider-session.ts`
- `source/host/extensions/mcp/mcp-service.ts`
- `source/host/extensions/settings/settings-service.ts`
- `source/host/main.ts`
- `source/node-agent-coordinator/inference-router.ts`
- `source/node-agent-coordinator/main.ts`
- `source/node-agent-coordinator/routed-mcp-bridge.ts`
- `source/shared/box-runtime.ts`
- `source/shared/host-settings.ts`
- `source/shared/inference-router.ts`
- `source/shared/local-tool-permission.ts`
- `source/shared/node/inference-router-local.ts`
- `source/shared/node/settings/sand-settings-store.ts`
- `source/shared/rpc/coordinator.ts`
- `source/shared/rpc/main.ts`
- `src/app/package.json`
- `tests/backend-mcp-exec-json.test.mjs`
- `tests/codex-direct-responses.test.mjs`
- `tests/inference-router-transcript.test.mjs`
- `tests/publication-bootstrap.test.mjs`
- `tests/publication-packaging.test.mjs`
- `tests/reconstructed-updater-guard.test.mjs`
- `tests/research-archives.test.mjs`
- `tests/router-settings.test.mjs`