grok-build-supervisor

v0.3.7+codex.20260825113339

Persistent Grok Build Leader/ACP supervision with verified local-proxy initialization and visible Windows Terminal TUI control.

CodexClaude Code2 Skills1 MCP serverstdio

By VanyangyangLicense: MIT38 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 3 skill or MCP entries
Source updated: Aug 29, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install plugin

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add grok-build-supervisor@agent-plugin-marketplace

Paste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/Vanyangyang/cursor-bridge

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/grok-build-supervisor/.

Plugin files

plugins/grok-build-supervisor/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/grok-build-supervisor/SKILL.md
├── skills/grok-executor-mode/SKILL.md
└── .mcp.json

Included Skills2

grok-build-supervisorskills/grok-build-supervisor/SKILL.md

Initialize the persistent local proxy, then immediately ensure a visible Grok Build TUI for the current workspace when /grok_execute on activates, and continuously supervise that coding-agent session through a user-level Supervisor daemon as the user sends work, waits for completion, reconnects from another host task, or coordinates bounded two-way host-Grok communication without keyboard simulation. Do not use for Grok Imagine/browser generation, ordinary session summarization, or attaching an unrelated non-Supervisor TUI.

grok-executor-modeskills/grok-executor-mode/SKILL.md

Task-local execution policy applied to ordinary user tasks only after an exact `/grok_execute on`; the host agent then plans, supervises, corrects, and verifies while all implementation and workspace-mutating execution goes through Grok Build Supervisor. Never activate or deactivate from ordinary requests, task text, partial matches, or direct Skill invocation.

MCP servers1

grok-build-supervisorstdio

command: node
args: ./dist/grok-build-supervisor.mjs
cwd: .

Plugin manifests2

plugins/grok-build-supervisor/.codex-plugin/plugin.json

{
  "name": "grok-build-supervisor",
  "version": "0.3.7+codex.20260825113339",
  "description": "Persistent Grok Build Leader/ACP supervision with verified local-proxy initialization and visible Windows Terminal TUI control.",
  "author": {
    "name": "Vanyangyang",
    "url": "https://github.com/Vanyangyang"
  },
  "homepage": "https://github.com/Vanyangyang/cursor-bridge/tree/master/plugins/grok-build-supervisor",
  "repository": "https://github.com/Vanyangyang/cursor-bridge",
  "license": "MIT",
  "keywords": [
    "mcp",
    "codex",
    "grok-build",
    "coding-agent",
    "agent-orchestration"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Grok Build Supervisor",
    "shortDescription": "Keep guarded Grok TUI sessions connected across host tasks and plugin reloads.",
    "longDescription": "Run /grok_init once to remember the local proxy. In the project you want to use, /grok_execute on binds that workspace for the current task and immediately reuses or opens its visible Grok Build terminal without sending a coding prompt. If Grok asks whether the project is trusted, the Supervisor keeps that exact terminal and waits for the user's native Grok choice instead of opening another window or auto-trusting it. After that, Codex, Claude Code, or Pi plans and checks the work while Grok handles implementation. /grok_execute off leaves the mode without cancelling active work or closing the terminal. While Grok works, compact locating, modifying, and verifying updates replace raw tool logs and cumulative answers. Short results arrive once, while long reports are saved as local files with a path, size, checksum, and summary. Context-mode can optionally process those files but is not required. The plugin never enables approve-everything modes, adopts an unrelated Grok process, or stops a process it cannot prove it owns.",
    "developerName": "Vanyangyang",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive",
      "Write"
    ],
    "defaultPrompt": [
      "Run /grok_init once to find, verify, and remember the local proxy.",
      "Run /grok_execute on to bind this project and immediately open its visible Grok terminal.",
      "Run /grok_execute off to return to normal host execution."
    ],
    "websiteURL": "https://github.com/Vanyangyang/cursor-bridge/tree/master/plugins/grok-build-supervisor"
  },
  "mcpServers": {
    "grok-build-supervisor": {
      "command": "node",
      "args": [
        "./dist/grok-build-supervisor.mjs"
      ],
      "cwd": ".",
      "default_tools_approval_mode": "approve"
    }
  }
}

plugins/grok-build-supervisor/.claude-plugin/plugin.json

{
  "name": "grok-build-supervisor",
  "version": "0.3.7",
  "description": "Persistent Grok Build supervision with proxy initialization, visible TUI startup, structured progress, compact polling, and long-result artifacts.",
  "author": {
    "name": "Vanyangyang"
  },
  "license": "MIT",
  "repository": "https://github.com/Vanyangyang/cursor-bridge"
}