bwoc-plugin-codex

BWOC → OpenAI Codex plugin adapter — bring the BWOC agent fleet into OpenAI Codex.

---

✨ Overview

bwoc-plugin-codex packages the BWOC agent fleet as an OpenAI Codex plugin — a bundle of skills, hooks, and (optionally) MCP servers that let Codex drive your BWOC workspace: list agents, send work, run headless tasks, coordinate teams, and read shared memory.

It is declarative + shell-out: every skill wraps the bwoc CLI. No background server, no daemon.

Note

Status: WIP. Coordination skills, hooks, a repo-local marketplace, and skill re-export are implemented and wrap the bwoc CLI. Remaining: a host smoke-test — see the roadmap.

🧩 What it exposes

Surface	BWOC capability	Wraps
Skills	Coordinate the fleet	bwoc list · status · send · run · chat · task · team
Skills	Reuse BWOC skills	BWOC skills re-exported as skills/<name>/SKILL.md
Hooks	Lifecycle side effects	hooks/hooks.json
Memory	Shared deep-memory	bwoc memory bridge

🏗️ How it works

Codex  ──@bwoc skill──▶  skill instructions  ──exec──▶  bwoc CLI  ──▶  BWOC workspace
                                                                       (agents, teams,
                                                                        tasks, memory)

Hook commands receive PLUGIN_ROOT and PLUGIN_DATA in the environment. Every surface is a thin wrapper over a bwoc subcommand.

📋 Prerequisites

• OpenAI Codex
• The bwoc CLI installed and on PATH
• 📚 Reference: the BWOC Handbook
• A BWOC workspace (bwoc init) reachable from where Codex runs

📦 Installation

Add this repo to a marketplace, then enable it. A repo-local marketplace lives at $REPO_ROOT/.agents/plugins/marketplace.json; a personal one at ~/.agents/plugins/marketplace.json.

# browse / install from the Codex CLI
/plugins

Enable in ~/.codex/config.toml:

[plugins."bwoc@bwoc"]
enabled = true

🚀 Usage

@bwoc list                 # list registered agents
@bwoc status <agent>   # health + identity snapshot
@bwoc send <agent> ... # append a message to an agent's inbox
@bwoc run  <agent> ... # run a single task headless, capture result
"Summarize the BWOC team's open tasks"   # natural-language invocation

🗂️ Repository layout

bwoc-plugin-codex/
├── .codex-plugin/
│   └── plugin.json          # plugin manifest (name/version/description/skills/hooks)
├── skills/                  # skills wrapping `bwoc` (skills/<name>/SKILL.md)
├── hooks/hooks.json         # lifecycle hooks
├── .mcp.json                # optional MCP servers
└── scripts/                 # validate.sh / build.sh

🛠️ Development

bash scripts/validate.sh     # validate .codex-plugin/plugin.json
bash scripts/build.sh        # regenerate the host tree from the live workspace
prettier --check .           # lint

🗺️ Roadmap

• Scaffold: manifest, README, license
• Coordination skills (list/status/send/run/chat/task/team)
• Deep-memory skill
• .agents/plugins/marketplace.json for repo-local install
• Skill re-export from BWOC skills (scripts/sync-skills.sh)
• Smoke test inside Codex

🔗 BWOC host-adapter set

One of seven BWOC → host adapters, one per agent host:

Host	Repo
Claude Code	bwoc-plugin-claude
OpenAI Codex	bwoc-plugin-codex
Antigravity	bwoc-plugin-agy
OpenClaw	bwoc-plugin-openclaw
Hermes	bwoc-plugin-hermes
Cursor	bwoc-plugin-cursor
Vercel	bwoc-plugin-vercel

🙏 Maintainer

Maintained by Bemind Technology, part of the BWOC host-adapter set. This connector is generic: it ships no agents, teams, or workspace identities of its own — it discovers your fleet from the local bwoc workspace at runtime.

🤝 Contributing

Issues and PRs welcome. Keep the plugin a thin wrapper over the bwoc CLI — logic belongs in the framework, not here.

📄 License

MIT © Bemind Technology