ccycv/codex-opencode-worker

OpenCode Worker for Codex is a small plugin that lets one coding-assistant tool hand work off to another. Codex is OpenAI's command-line coding assistant, and OpenCode is a different open-source coding agent. This plugin sets up Codex as the planner and reviewer, while OpenCode does the actual implementation work in the background. The README calls this a planner / executor split: Codex thinks about the task, supervises, and checks the result, while OpenCode goes off and writes the code. The expected workflow is described step by step. Codex first agrees a plan with the user. It then checks whether OpenCode is already running, optionally verifies that the requested model is available, starts an OpenCode run with the plan and acceptance criteria, and waits for it to finish without interrupting. Once OpenCode exits, Codex reads the log, the parsed run summary, and the list of changed files, runs any relevant tests or builds, and compares the result against the original request. If something is missing, Codex delegates a focused follow-up to OpenCode. The README states the plugin deliberately offers no stop, cancel, or kill tool. The plugin is presented to Codex as a set of MCP tools (MCP is a protocol for connecting tools to coding assistants). The tools include opencode_start and opencode_run_and_wait to kick off a run, opencode_status and opencode_wait for monitoring, opencode_logs and opencode_run_summary to inspect the output, opencode_changed_files to see what was modified, opencode_usage for token and cost stats, and opencode_models plus opencode_check_model for picking and validating a model. Requirements are Node.js, a Mac or Linux environment, and OpenCode installed and signed in. The README shows a one-line install command for OpenCode and lists the paths the worker checks to find its binary. Models are selected by passing a provider/model string, which gets forwarded as a command-line flag to OpenCode. Installation as a Codex plugin involves cloning the repo into a local plugins directory and registering it in a marketplace JSON file plus a config.toml file. There is also a direct MCP server registration mode for Codex builds that do not yet expose local plugins. State and JSONL logs live under ~/.local/state/codex-opencode-worker/. The README closes with safety notes: the worker refuses to start a second task while one is alive, the wait tool only waits, and OpenCode may modify files according to its prompt and permissions, so changes should be reviewed after each run.