opencode-worker

v0.2.0

Drive a self-hosted OpenCode instance as async background workers over MCP.

Codex4 Skills1 MCP serverStreamable HTTP

By ManuOtelLicense: PolyForm-Noncommercial-1.0.00 GitHub starsUpdated 46 minutes ago

Directory evidence

Runtimes: Codex
Parsed components: 5 skill or MCP entries
Source updated: Sep 3, 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 opencode-worker for Codex

Installs for the current user

codex plugin marketplace add ManuOtel/opencode-mcp-bridge
codex plugin marketplace upgrade opencode-mcp-bridge
codex plugin add opencode-worker@opencode-mcp-bridge

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

Compatibility: the page URL and API slug “opencode-worker” remain stable.

Codex: opencode-worker@agent-plugin-marketplace → opencode-worker@opencode-mcp-bridge

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/ManuOtel/opencode-mcp-bridge

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

opencode-worker/

├── .codex-plugin/plugin.json
├── skills/delegate-to-opencode/SKILL.md
├── skills/opencode-git-workflow/SKILL.md
├── skills/recover-opencode-task/SKILL.md
├── skills/verify-opencode-work/SKILL.md
└── .mcp.json

Included Skills4

delegate-to-opencodeskills/delegate-to-opencode/SKILL.md

Scope and launch an async OpenCode worker task with free-model defaults, acceptance criteria, and polling.

opencode-git-workflowskills/opencode-git-workflow/SKILL.md

Branch, worktree, commit, merge, and PR protocol for OpenCode worker tasks with conflict and authorization rules.

recover-opencode-taskskills/recover-opencode-task/SKILL.md

Diagnose and recover unknown, error, or stuck OpenCode worker tasks safely without duplicate side effects.

verify-opencode-workskills/verify-opencode-work/SKILL.md

Independently verify a finished OpenCode worker task via diffs, tests, and evidence before accepting it.

MCP servers1

opencodeStreamable HTTP

url: https://opencode-mcp.manuotel.com/worker-mcp

Plugin manifests1

.codex-plugin/plugin.json

{
  "name": "opencode-worker",
  "version": "0.2.0",
  "description": "Drive a self-hosted OpenCode instance as async background workers over MCP.",
  "author": {
    "name": "ManuOtel",
    "url": "https://github.com/ManuOtel"
  },
  "homepage": "https://github.com/ManuOtel/opencode-mcp-bridge",
  "repository": "https://github.com/ManuOtel/opencode-mcp-bridge",
  "license": "PolyForm-Noncommercial-1.0.0",
  "keywords": [
    "opencode",
    "mcp",
    "workers",
    "codex",
    "async"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "OpenCode Worker",
    "shortDescription": "Run OpenCode as async background workers",
    "longDescription": "Scope worker tasks, poll status, verify diffs, recover stuck tasks, and follow the git worktree protocol.",
    "developerName": "ManuOtel",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/ManuOtel/opencode-mcp-bridge",
    "defaultPrompt": [
      "List free OpenCode worker models I can use.",
      "Start an OpenCode worker to implement my task.",
      "Check my OpenCode worker status and verify its diff."
    ]
  }
}