{"_id":"@asural/grok-bridge","_rev":"6-e9a9f9eb66e9d3d8ffcc89cbb94c097f","name":"@asural/grok-bridge","dist-tags":{"latest":"0.8.11"},"versions":{"0.0.0":{"name":"@asural/grok-bridge","version":"0.0.0","_id":"@asural/grok-bridge@0.0.0","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"dist":{"shasum":"f5ebf3f0e5cc1ccb1184814c8e0f02995e338d67","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.0.0.tgz","fileCount":1,"integrity":"sha512-l1lviwYV+qw88UYXx82bmmKp74tHvRd5lZI6mrhuqRO6omSVX2+LF9KKTngLDyaJVvnYCCbv0xHT5B/mVUkd7A==","signatures":[{"sig":"MEUCIQCGOFL0TVP1ruMdJP4a6OIGPpHoMOQdLf9/j4EDy1pZqQIgC+FiW4oKRNlP8CHMO3fMCT61tlcpRNDwEp88XqUE2A8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96},"private":false,"_npmUser":{"name":"asural","email":"luodaoyi@gmail.com"},"_npmVersion":"9.2.0","description":"bootstrap stub","directories":{},"_nodeVersion":"20.19.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/grok-bridge_0.0.0_1787020912870_0.8857715929675964","host":"s3://npm-registry-packages-npm-production"}},"0.8.7":{"name":"@asural/grok-bridge","version":"0.8.7","keywords":["grok","build","agent","skill","cli","rust","tui"],"license":"MIT","_id":"@asural/grok-bridge@0.8.7","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"homepage":"https://github.com/luodaoyi/grok-bridge-rs","bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"bin":{"grok-bridge":"bin/cli.js"},"dist":{"shasum":"c574ce57490aa20ebc15d116f3b90114dd5c43e3","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.8.7.tgz","fileCount":5,"integrity":"sha512-FdzX0dkqrzTgMQhXF0EstUjH9nZBpXUOCabcXMP3BAnJKOcvorH88LZ2WrtRVbVDjJYbeC/iCNCSJPPT/oxRZA==","signatures":[{"sig":"MEYCIQCSbBEWi06j59mUqdn+1z4hJUdG2oEauQw9AlGUYOQK4AIhAMrgnVkSU4KvpHkukCBk3/TYXyEp//zLgQmxOTD+amyt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@asural%2fgrok-bridge@0.8.7","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27801},"engines":{"node":">=18"},"gitHead":"92ef38bf5add50e6b8edb05d2f67bccdfbe6813d","scripts":{"test":"cargo test --all-targets && cargo build && node test/launcher.test.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3ed82da7-2ce1-4b7b-ae3b-bed4b3afb20c"}},"repository":{"url":"git+https://github.com/luodaoyi/grok-bridge-rs.git","type":"git"},"_npmVersion":"11.17.0","description":"A local runtime server and CLI bridge for Grok Build","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"optionalDependencies":{"@asural/grok-bridge-linux-x64":"0.8.7","@asural/grok-bridge-win32-x64":"0.8.7","@asural/grok-bridge-darwin-x64":"0.8.7","@asural/grok-bridge-linux-arm64":"0.8.7","@asural/grok-bridge-win32-arm64":"0.8.7","@asural/grok-bridge-darwin-arm64":"0.8.7"},"_npmOperationalInternal":{"tmp":"tmp/grok-bridge_0.8.7_1787041803647_0.7635257792769274","host":"s3://npm-registry-packages-npm-production"}},"0.8.8":{"name":"@asural/grok-bridge","version":"0.8.8","keywords":["grok","build","agent","skill","cli","rust","tui"],"license":"MIT","_id":"@asural/grok-bridge@0.8.8","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"homepage":"https://github.com/luodaoyi/grok-bridge-rs","bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"bin":{"grok-bridge":"bin/cli.js"},"dist":{"shasum":"269f3ad8ad079c96194bddfe628dccdb08de4638","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.8.8.tgz","fileCount":5,"integrity":"sha512-b5EilncD/sttdE4NuQKFp6JKTquD2TfPIvNwY1OYNxk7v61ovZ75Hu2YwjJPAmC/qbschL68zMyemy81JnpYfA==","signatures":[{"sig":"MEUCIQDVI0M8IYSiRR0Am+W47Ppx5SmeXT1LZFDn91DVgc9YKAIgQRTVaZmDzoBVGxlBit/bI/YQFNgkePsnNfeLc3Dh9/w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@asural%2fgrok-bridge@0.8.8","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27801},"engines":{"node":">=18"},"gitHead":"ee72c6f92f8977ddcc1808c545f6c2eed4a66aa1","scripts":{"test":"cargo test --all-targets && cargo build && node test/launcher.test.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3ed82da7-2ce1-4b7b-ae3b-bed4b3afb20c"}},"repository":{"url":"git+https://github.com/luodaoyi/grok-bridge-rs.git","type":"git"},"_npmVersion":"11.17.0","description":"A local runtime server and CLI bridge for Grok Build","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"optionalDependencies":{"@asural/grok-bridge-linux-x64":"0.8.8","@asural/grok-bridge-win32-x64":"0.8.8","@asural/grok-bridge-darwin-x64":"0.8.8","@asural/grok-bridge-linux-arm64":"0.8.8","@asural/grok-bridge-win32-arm64":"0.8.8","@asural/grok-bridge-darwin-arm64":"0.8.8"},"_npmOperationalInternal":{"tmp":"tmp/grok-bridge_0.8.8_1787225717830_0.2712562556124436","host":"s3://npm-registry-packages-npm-production"}},"0.8.9":{"name":"@asural/grok-bridge","version":"0.8.9","keywords":["grok","build","agent","skill","cli","rust","tui"],"license":"MIT","_id":"@asural/grok-bridge@0.8.9","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"homepage":"https://github.com/luodaoyi/grok-bridge-rs","bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"bin":{"grok-bridge":"bin/cli.js"},"dist":{"shasum":"de5ed24f4a5384212998bcaaabdea6d3f83bdab8","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.8.9.tgz","fileCount":5,"integrity":"sha512-FdsG6rZ7WAqMGChu7dj3j2Nw1bTzuRPev94p86MEvi9gXTiokyB4x8e7+BKJFR41mof4s2nCaaWv65P77JEOGA==","signatures":[{"sig":"MEYCIQCn18YwtasEjIaObb+b6OmTQHUegYx91NOMxKHKdN3jmAIhAJpaszi2mPUWevncWTbD80I5KWRBMZXW5I4XYTYPe50Z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@asural%2fgrok-bridge@0.8.9","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27801},"engines":{"node":">=18"},"gitHead":"7a60cff4420e9fc088cab4b6533f6c18c09d6a0d","scripts":{"test":"cargo test --all-targets && cargo build && node test/launcher.test.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3ed82da7-2ce1-4b7b-ae3b-bed4b3afb20c"}},"repository":{"url":"git+https://github.com/luodaoyi/grok-bridge-rs.git","type":"git"},"_npmVersion":"11.17.0","description":"A local runtime server and CLI bridge for Grok Build","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"optionalDependencies":{"@asural/grok-bridge-linux-x64":"0.8.9","@asural/grok-bridge-win32-x64":"0.8.9","@asural/grok-bridge-darwin-x64":"0.8.9","@asural/grok-bridge-linux-arm64":"0.8.9","@asural/grok-bridge-win32-arm64":"0.8.9","@asural/grok-bridge-darwin-arm64":"0.8.9"},"_npmOperationalInternal":{"tmp":"tmp/grok-bridge_0.8.9_1787281083595_0.03620824311926474","host":"s3://npm-registry-packages-npm-production"}},"0.8.10":{"name":"@asural/grok-bridge","version":"0.8.10","keywords":["grok","build","agent","skill","cli","rust","tui"],"license":"MIT","_id":"@asural/grok-bridge@0.8.10","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"homepage":"https://github.com/luodaoyi/grok-bridge-rs","bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"bin":{"grok-bridge":"bin/cli.js"},"dist":{"shasum":"3de4a24f9a97d3be367d376fe6657509e753a941","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.8.10.tgz","fileCount":5,"integrity":"sha512-CAUFVFhuBKMERIWVkqcUF5cecD1PBdhNNDd6kugeLLs9mJUeEwH1bwZTyciPLVhky0hlmWm6IxHfHec0HWR1zA==","signatures":[{"sig":"MEQCIHc2YMRZlzXnKLYDgylsNkcQxgJh4qddEenpF/r3xSbIAiAIin4RqU37CoFB/imEaeKoOaMkAWv0RXrDdOCs1JCrLw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@asural%2fgrok-bridge@0.8.10","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27808},"engines":{"node":">=18"},"gitHead":"705debe175c28612123748aaf27b66677d40da38","scripts":{"test":"cargo test --all-targets && cargo build && node test/launcher.test.js"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3ed82da7-2ce1-4b7b-ae3b-bed4b3afb20c"}},"repository":{"url":"git+https://github.com/luodaoyi/grok-bridge-rs.git","type":"git"},"_npmVersion":"11.17.0","description":"A local runtime server and CLI bridge for Grok Build","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"optionalDependencies":{"@asural/grok-bridge-linux-x64":"0.8.10","@asural/grok-bridge-win32-x64":"0.8.10","@asural/grok-bridge-darwin-x64":"0.8.10","@asural/grok-bridge-linux-arm64":"0.8.10","@asural/grok-bridge-win32-arm64":"0.8.10","@asural/grok-bridge-darwin-arm64":"0.8.10"},"_npmOperationalInternal":{"tmp":"tmp/grok-bridge_0.8.10_1787288631191_0.8696172917084841","host":"s3://npm-registry-packages-npm-production"}},"0.8.11":{"name":"@asural/grok-bridge","version":"0.8.11","description":"A local runtime server and CLI bridge for Grok Build","license":"MIT","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"bin":{"grok-bridge":"bin/cli.js"},"scripts":{"test":"cargo test --all-targets && cargo build && node test/launcher.test.js"},"optionalDependencies":{"@asural/grok-bridge-win32-x64":"0.8.11","@asural/grok-bridge-win32-arm64":"0.8.11","@asural/grok-bridge-linux-x64":"0.8.11","@asural/grok-bridge-linux-arm64":"0.8.11","@asural/grok-bridge-darwin-x64":"0.8.11","@asural/grok-bridge-darwin-arm64":"0.8.11"},"repository":{"type":"git","url":"git+https://github.com/luodaoyi/grok-bridge-rs.git"},"homepage":"https://github.com/luodaoyi/grok-bridge-rs","bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"keywords":["grok","build","agent","skill","cli","rust","tui"],"engines":{"node":">=18"},"gitHead":"f4479ff1c0fffd12a2b95a381b153350e251a2cb","_id":"@asural/grok-bridge@0.8.11","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-e5RtACysXKNh0u/jc/9vZt8jKfz+ckDgVvNttT5F2QNzckyYawc02ss06EcZHEpNSr8/ej8q+rV+gcH3zAT95w==","shasum":"c82d8119063fc0546d9661025f44c2d1abbb5850","tarball":"https://registry.npmjs.org/@asural/grok-bridge/-/grok-bridge-0.8.11.tgz","fileCount":5,"unpackedSize":27808,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@asural%2fgrok-bridge@0.8.11","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH8h16Vhr1k+kwzjTk/vGJ/NDqg6bIk9FPN11yE5gqyNAiEAmMJvMNfDZYjq/MDfLlE120HN6r7SFLQhkb80wh4s8AY="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:3ed82da7-2ce1-4b7b-ae3b-bed4b3afb20c"}},"directories":{},"maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/grok-bridge_0.8.11_1787296750960_0.08373011522286311"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-18T02:41:52.651Z","modified":"2026-08-21T07:19:11.419Z","0.0.0":"2026-08-18T02:41:53.024Z","0.8.7":"2026-08-18T08:30:03.804Z","0.8.8":"2026-08-20T11:35:18.007Z","0.8.9":"2026-08-21T02:58:03.725Z","0.8.10":"2026-08-21T05:03:51.342Z","0.8.11":"2026-08-21T07:19:11.107Z"},"bugs":{"url":"https://github.com/luodaoyi/grok-bridge-rs/issues"},"license":"MIT","homepage":"https://github.com/luodaoyi/grok-bridge-rs","keywords":["grok","build","agent","skill","cli","rust","tui"],"repository":{"type":"git","url":"git+https://github.com/luodaoyi/grok-bridge-rs.git"},"description":"A local runtime server and CLI bridge for Grok Build","maintainers":[{"name":"asural","email":"luodaoyi@gmail.com"}],"readme":"# grok-build Local Runtime Skill\n\n<p>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/actions/workflows/ci.yml?query=branch%3Amain\"><img alt=\"Build\" src=\"https://img.shields.io/github/actions/workflow/status/luodaoyi/grok-bridge-rs/ci.yml?branch=main&label=build&logo=githubactions&logoColor=white\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/actions/workflows/release.yml\"><img alt=\"Release Workflow\" src=\"https://img.shields.io/github/actions/workflow/status/luodaoyi/grok-bridge-rs/release.yml?label=release&logo=githubactions&logoColor=white\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/releases/latest\"><img alt=\"Latest Release\" src=\"https://img.shields.io/github/v/release/luodaoyi/grok-bridge-rs?display_name=tag&sort=semver\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/releases\"><img alt=\"Release Downloads\" src=\"https://img.shields.io/github/downloads/luodaoyi/grok-bridge-rs/total?label=release%20downloads\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/stargazers\"><img alt=\"Stars\" src=\"https://img.shields.io/github/stars/luodaoyi/grok-bridge-rs?style=flat\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/issues\"><img alt=\"Issues\" src=\"https://img.shields.io/github/issues/luodaoyi/grok-bridge-rs\" /></a>\n  <a href=\"https://github.com/luodaoyi/grok-bridge-rs/blob/main/LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/github/license/luodaoyi/grok-bridge-rs\" /></a>\n</p>\n\n[English](README.md) | [简体中文](README-CN.md)\n\ngrok-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.\n\nThe 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.\n\n## WebUI Preview\n\n### Light theme (English)\n\n![grok-build WebUI light theme in English](images/light-en.jpg)\n\n### Dark theme (English)\n\n![grok-build WebUI dark theme in English](images/dark-en.jpg)\n\n## Why Use It?\n\nWhen 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:\n\n- **Local-first:** no Python, MCP server, cloud relay, or separate service installation is required.\n- **One runtime:** sessions are created and kept by one local process, so repeated Codex requests do not leave unmanaged bridges behind.\n- **Live control:** Grok remains a real interactive terminal. You can inspect output, send another instruction, attach a terminal, or stop it.\n- **Clear ownership:** sessions are grouped by the Codex conversation and its short title, even when several Codex conversations run at once.\n- **Browser management:** `server ui` opens a local panel with status, recent activity, terminal output, working directory, and close actions.\n- **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.\n- **Room for concurrent work:** there is no artificial 64-session cap. Practical capacity depends on your machine and Grok CLI.\n\n## Quick Start\n\n### 1. Install Grok CLI\n\nInstall and sign in to Grok CLI first. Confirm that it is available in your terminal:\n\n```text\ngrok --version\n```\n\n### 2. Install grok-bridge\n\n**Option A: npm Global Install (Recommended)**\n\n```bash\npnpm add -g grok-bridge-rs@latest\n# or: npm install -g grok-bridge-rs@latest\n# or: yarn global add grok-bridge-rs@latest\n```\n\nAfter installation, run:\n\n```bash\ngrok-bridge\n```\n\nIf your terminal supports interactive TTY (stdin + stdout both are TTYs), a Chinese TUI will open automatically. The menu offers:\n\n1. **安装 / 更新并自动配置 Grok** — Extract skill files and native binary to `~/.agents/skills/grok-build/`, then install Grok hooks.\n2. **移除本工具的 Grok Hooks 配置** — Uninstall only the hooks managed by this tool; preserves the binary and other hooks.\n3. **打开 WebUI** — Starts the runtime server and opens the WebUI in your browser.\n4. **退出** — Exit the TUI.\n\nFor headless/script use, you can also run:\n\n```bash\ngrok-bridge install       # Install and configure\ngrok-bridge status install   # Check installation status (JSON)\ngrok-bridge uninstall     # Remove hooks only\n```\n\n**Managing the singleton Runtime server:**\n\nTo check the current server state:\n\n```bash\ngrok-bridge server status\ngrok-bridge list\n```\n\nIf you need to restart the server (e.g., after upgrading or configuration changes), confirm no critical sessions are running, then:\n\n```bash\ngrok-bridge server stop\ngrok-bridge server start\ngrok-bridge server status\n```\n\nAfter upgrading to a newer version via npm, run **安装 / 更新** (or `grok-bridge install`) to update the skill-dir binary copy.\n\n**Option B: Manual ZIP Install**\n\nDownload 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/`.\n\nThe 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.\n\n### 3. Check and open the panel\n\nWindows PowerShell:\n\n```powershell\n$bridge = \"$env:USERPROFILE\\.agents\\skills\\grok-build\\bin\\windows-x86_64\\grok-bridge.exe\"\n& $bridge doctor\n& $bridge hooks install\n& $bridge server ui\n```\n\nLinux or macOS:\n\n```sh\nbridge=\"$HOME/.agents/skills/grok-build/bin/linux-x86_64/grok-bridge\"\n\"$bridge\" doctor\n\"$bridge\" hooks install\n\"$bridge\" server ui\n```\n\nReplace 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`.\n\nAfter 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.\n\n## Install or Update with Your Agent\n\nClaude 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`.\n\n### One-time installation prompt\n\n```text\nYou are [HOST AGENT]. Install the grok-build Agent Skill from the official latest GitHub Release: https://github.com/luodaoyi/grok-bridge-rs/releases/latest\n\nFirst 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.\n\nDownload 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.\n\nAfter 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.\n```\n\nHost-specific first lines:\n\n- Claude Code: `You are Claude Code. Install the grok-build Agent Skill...`\n- Codex: `You are Codex. Install the grok-build Agent Skill...`\n- OpenCode: `You are OpenCode. Install the grok-build Agent Skill...`\n\n### Update or upgrade prompt\n\n```text\nYou 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.\n\nFind 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.\n\nStage 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.\n\nReport 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.\n```\n\nThese 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`.\n\n## Everyday Use\n\n1. Ask Codex to delegate a coding task to Grok. The Skill records a short, readable title for the Codex conversation.\n2. Open `server ui` to see all Codex groups, expand the one you need, and read the current terminal screen and activity.\n3. Let Codex continue normally, or send a follow-up instruction from the CLI or attached terminal.\n4. Close an individual Grok session, close all sessions for one Codex conversation with `close-codex`, or stop the complete runtime when you are done.\n\nThe WebUI is an inspection and control surface, not a replacement for your editor or Git workflow. Your files and commands remain on your machine.\n\n## Requirements and Safety\n\n- Grok CLI must already be installed and authenticated.\n- Grok and its tools run with your current user permissions. Review prompts before enabling automatic approval.\n- The WebUI has no login and is intended for the local loopback address only. Do not expose it on a public interface.\n- Do not put passwords, tokens, or other secrets in prompts, session titles, or environment variables shown in the panel.\n- Download releases from a trusted source and verify the provided SHA-256 file.\n\n## Troubleshooting\n\nIf `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`:\n\n```sh\ngrok-bridge server stop\ngrok-bridge server start\n```\n\nUnix 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.\n\n## Project Links\n\n- [Source code](https://github.com/luodaoyi/grok-bridge-rs)\n- [Releases](https://github.com/luodaoyi/grok-bridge-rs/releases)\n- [Issues and feature requests](https://github.com/luodaoyi/grok-bridge-rs/issues)\n- [Linux DO community](https://linux.do/)\n- [MIT License](LICENSE)\n","readmeFilename":"README.md"}