What it is

GrokGo is a local Grok / xAI gateway desktop application designed to connect to Codex and OpenAI-compatible clients. It consolidates OAuth/account management, local proxy, MCP tooling, multi-account routing, and usage statistics behind a local gateway. The project targets running gateway services locally and exposing an API surface for client integration.

How it works

The gateway runs locally and exposes API endpoints for base, responses, chat completions, images, and MCP. It provides multi-account support via OAuth hosting, load balancing, and token refresh. It offers one-click integration for Codex MCP injection and supports importing accounts, with a configuration directory that stores gateway settings, accounts, and logs.

Getting started

Installation

From Releases download corresponding platform installer:

macOS Apple Silicon | `GrokGo_*_aarch64.dmg`
macOS Intel | `GrokGo_*_x64.dmg`
Windows x64 | `.msi` / `.exe`

First run

1. Start GrokGo and verify the overview page shows the gateway as running.
2. Open the Accounts page to log in or batch import accounts.
3. On the Overview page, copy:
   • Base URL: http://127.0.0.1:<port>/v1
   • Local Token
4. (Optional) On Integrations, inject Codex MCP or import CC Switch.

Default port is 8787 and will increment if in use.

Manual configuration for clients

1. Start GrokGo and copy the Base URL and Local Token from Overview.
2. Use Responses API (or OpenAI Chat Completions compatible mode) in the client.
3. Set:
   • Base URL: http://127.0.0.1:<port>/v1
   • Authorization: Bearer <localToken>

### One-click MCP injection
In Integrations enable MCP injection; the example TOML shows how to configure an MCP server pointing to the local gateway with appropriate Authorization header.

## Recent releases
Latest releases provide GrokGo v0.1.9 through v0.1.5 with platform-specific installers (macOS aarch64/x64, Windows x64). Each release lists the corresponding installer file names in the Downloads section. The latest entry is v0.1.9 (2026-07-16).

## API endpoints
Local gateway exposes:
- Base: `http://127.0.0.1:<port>/v1`
- Responses: `POST /v1/responses`
- Chat Completions: `POST /v1/chat/completions`
- Images: `POST /v1/images/generations`, `POST /v1/images/edits`
- MCP: `http://127.0.0.1:<port>/mcp`

## Configuration
Configuration directory at `~/.grok-go/` with files: `config.json`, `auth.json`, `data.db`, `artifacts/`, `backups/`, `agents-guide.md`.

## macOS specific
Release builds are not notarized; Gatekeeper may show as damaged. Suggested workaround commands are provided to bypass the warning.

## Development and build
Commands:

dependencies

pnpm install

development (frontend + tauri)

pnpm tauri dev

frontend only

pnpm dev:ui

production build

pnpm tauri build

Supported tech: Tauri 2, Rust, React + TypeScript + Vite, Tailwind.

## Documentation and contribution
The project mentions slowed maintenance and invites feedback, with links to contributing and security docs.