grok-bridge-rs

KO | EN

gitlite — search

#javascript #react #llm #deep-learning #linux #docker #java #windows #awesome #cli #security #pytorch #ios #open-source

(★ 57)

本地 Grok Runtime，为多种 AI 编程 Agent 提供可管理的交互式会话 | Local Grok runtime for manageable interactivesessions across AI coding agents

grok-bridge-rs Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# grok-build Local Runtime Skill

[English](README.md) | [简体中文](README-CN.md)

grok-build gives Codex a reliable local way to use Grok for real software work without creating a new unmanaged process for every request. Its shared runtime keeps sessions visible, interactive, grouped by Codex conversation, and easy to close from a browser.

The WebUI includes a language switcher with 15 locales: English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Russian, Spanish, French, German, Indonesian, Thai, Vietnamese, Arabic, Portuguese (Brazil), and Portuguese (Portugal). It follows the browser language on first visit, remembers the selected language locally, and uses a right-to-left layout for Arabic.

## WebUI Preview

### Light theme (English)

![grok-build WebUI light theme in English](https://raw.githubusercontent.com/luodaoyi/grok-bridge-rs/main/images/light-en.jpg)

### Dark theme (English)

![grok-build WebUI dark theme in English](https://raw.githubusercontent.com/luodaoyi/grok-bridge-rs/main/images/dark-en.jpg)

## Why Use It?

When Codex hands work to Grok, you should not have to guess which process belongs to which task or whether it is still doing useful work. grok-build keeps that workflow in one place:

- **Local-first:** no Python, MCP server, cloud relay, or separate service installation is required.
- **One runtime:** sessions are created and kept by one local process, so repeated Codex requests do not leave unmanaged bridges behind.
- **Live control:** Grok remains a real interactive terminal. You can inspect output, send another instruction, attach a terminal, or stop it.
- **Clear ownership:** sessions are grouped by the Codex conversation and its short title, even when several Codex conversations run at once.
- **Browser management:** `server ui` opens a local panel with status, recent activity, terminal output, working directory, and close actions.
- **Useful cleanup:** Hooks report Grok activity, while heartbeat and lease handling help identify disconnected sessions. Close one session or everything owned by a Codex conversation.
- **Room for concurrent work:** there is no artificial 64-session cap. Practical capacity depends on your machine and Grok CLI.

## Quick Start

### 1. Install Grok CLI

Install and sign in to Grok CLI first. Confirm that it is available in your terminal:

```text
grok --version
```

### 2. Install the Skill

Download the latest ZIP from [GitHub Releases](https://github.com/luodaoyi/grok-bridge-rs/releases), then extract it into your Agent Skills directory. The extracted folder should be `grok-build/`.

The ZIP includes native binaries for Windows x86_64/ARM64, Linux x86_64/ARM64, and macOS Intel/Apple Silicon. Choose the binary that matches your system.

### 3. Check and open the panel

Windows PowerShell:

```powershell
$bridge = "$env:USERPROFILE\.agents\skills\grok-build\bin\windows-x86_64\grok-bridge.exe"
& $bridge doctor
& $bridge hooks install
& $bridge server ui
```

Linux or macOS:

```sh
bridge="$HOME/.agents/skills/grok-build/bin/linux-x86_64/grok-bridge"
"$bridge" doctor
"$bridge" hooks install
"$bridge" server ui
```

Replace the binary directory with `windows-arm64`, `linux-arm64`, `macos-x86_64`, or `macos-arm64` when needed. `server ui` starts the local runtime on demand and opens the browser panel. The default address is `http://127.0.0.1:47653`.

After the Skill is installed, Codex can use it directly. The panel is there when you want to see what every Grok session is doing or take manual control.

## Install or Update with Your Agent

Claude Code, Codex, and OpenCode can install or update this Skill for you. The prompts below are deliberately host-aware: the agent must inspect its own Skill discovery rules instead of assuming that another tool's directory is correct. Replace `[HOST AGENT]` with `Claude Code`, `Codex`, or `OpenCode`.

### One-time installation prompt

```text
You are [HOST AGENT]. Install the grok-build Agent Skill from the official latest GitHub Release: https://github.com/luodaoyi/grok-bridge-rs/releases/latest

First inspect this host's Skill discovery rules and choose the correct user-level Skill directory. Do not guess from another Agent's conventions. Install the extracted folder as grok-build/ and keep the bundled SKILL.md, agents/openai.yaml, hooks/, and platform-specific bin/ files. Detect the current operating system and CPU architecture, but keep all native binaries in the release archive.

Download the release ZIP and its matching .sha256 file, verify the SHA-256 before extracting, and stop if verification fails. Do not install Grok CLI, use sudo or administrator privileges, run remote scripts, modify the current project, or change unrelated Skills. If a previous grok-build installation exists, preserve any files outside that Skill and report the path and any custom files inside it before replacing it.

After installation, run the bundled grok-bridge doctor command and grok-bridge hooks install command using the binary for this host. Do not start the WebUI unless I ask. Report the exact Skill path, release tag, selected platform binary, checksum result, and command results. Do not commit, push, or publish anything.
```

Host-specific first lines:

- Claude Code: `You are Claude Code. Install the grok-build Agent Skill...`
- Codex: `You are Codex. Install the grok-build Agent Skill...`
- OpenCode: `You are OpenCode. Install the grok-build Agent Skill...`

### Update or upgrade prompt

```text
You are [HOST AGENT]. Update the installed grok-build Agent Skill to the newest official release from https://github.com/luodaoyi/grok-bridge-rs/releases/latest.

Find the currently active grok-build installation using this host's Skill discovery rules and report its path and current release if available. Check the latest release tag first; if it is already installed, do not reinstall it. Otherwise download the release ZIP and matching .sha256 file, verify the SHA-256 before extraction, and select the native binary for the current operating system and CPU architecture.

Stage the verified replacement before switching to it. Replace only the grok-build Skill, preserve unrelated Skills and files outside that directory, and stop before overwriting any custom files inside the existing Skill; report them first. After the switch, run the new grok-bridge doctor command and grok-bridge hooks install command. Do not install Grok CLI, use sudo or administrator privileges, run remote scripts, modify the current project, start the WebUI, commit, push, or publish anything unless I explicitly ask.

Report the old and new release tags, Skill path, platform binary, checksum result, preserved custom files, and command results. If the download, verification, or replacement cannot be completed safely, leave the current installation unchanged and explain why.
```

These prompts keep the installation compatible with the host Agent while the Skill itself remains local-only. After installation, invoke it using the host's normal Skill syntax; in Codex this is `$grok-build`.

## Everyday Use

1. Ask Codex to delegate a coding task to Grok. The Skill records a short, readable title for the Codex conversation.
2. Open `server ui` to see all Codex groups, expand the one you need, and read the current terminal screen and activity.
3. Let Codex continue normally, or send a follow-up instruction from the CLI or attached terminal.
4. Close an individual Grok session, close all sessions for one Codex conversation with `close-codex`, or stop the complete runtime when you are done.

The WebUI is an inspection and control surface, not a replacement for your editor or Git workflow. Your files and commands remain on your machine.

## Requirements and Safety

- Grok CLI must already be installed and authenticated.
- Grok and its tools run with your current user permissions. Review prompts before enabling automatic approval.
- The WebUI has no login and is intended for the local loopback address only. Do not expose it on a public interface.
- Do not put passwords, tokens, or other secrets in prompts, session titles, or environment variables shown in the panel.
- Download releases from a trusted source and verify the provided SHA-256 file.

## Troubleshooting

If `create` reports that the Grok state directory is not writable, the singleton Runtime inherited a filesystem sandbox that prevents Grok from creating session data. Check `list` before stopping anything. After confirming it is safe to interrupt the affected singleton, stop it and start the Runtime from a user context that can write `GROK_HOME` or the default `~/.grok`:

```sh
grok-bridge server stop
grok-bridge server start
```

Unix Runtime startup creates a separate process session, so the Server remains available after this command exits. Retry `create` after `server status` confirms that the singleton is running.

## Project Links

- [Source code](https://github.com/luodaoyi/grok-bridge-rs)
- [Releases](https://github.com/luodaoyi/grok-bridge-rs/releases)
- [Issues and feature requests](https://github.com/luodaoyi/grok-bridge-rs/issues)
- [Linux DO community](https://linux.do/)
- [MIT License](LICENSE)

grok-bridge-rs

grok-bridge-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

grok-bridge-rs

grok-bridge-rs Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README