Parallel Codex MCP server with live task monitoring, batch wait, and full flag parity
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"codex-mcp-swarm","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# codex-mcp-swarm An MCP server that wraps OpenAI's Codex CLI with **true parallel execution** and **live task monitoring**. Zero dependencies -- single Python file, stdlib only. ## Why? The official `codex mcp-server` processes requests sequentially. If your MCP client (Claude Code, etc.) needs to run 5 Codex tasks, they queue up one after another. This server spawns each task as an independent subprocess, so they run in parallel. **Unique features no other Codex MCP wrapper has:** - **Worktree isolation** -- `worktree: true` creates an isolated git worktree per task so parallel Codex instances never edit past each other - **Batch wait** -- launch N tasks, call `codex_wait` once, get all results when they finish - **Live status** -- see what each Codex task is doing right now (last tool call, current reasoning, progress) - **Full flag parity** -- same parameters as the official Codex MCP tool (`sandbox`, `approval-policy`, `cwd`, `model`, `config`, etc.) - **Drop-in config** -- accepts the same `-c key=value` server args as `codex mcp-server` ## Tools | Tool | Description | |------|-------------| | `codex` | Synchronous execution (drop-in replacement for official); terminal failures include the model, structured cause, category, and retryability | | `codex_async` | Launch a task, get a `task_id` immediately (fan-out). **Not** fire-and-forget: results come back only via `codex_wait`. Pass `threadId` to resume a session | | `codex_reply` | Continue a previous session via `codex exec resume`; uses the same structured failure reporting as `codex` | | `codex_status` | Live view: tools called, last command, current thinking, warnings, and terminal failure cause | | `codex_wait` | Block until multiple tasks complete and return results or structured failure details | | `codex_cancel` | Kill a running async task (preserves worktree for inspection); if it already failed, return the recorded cause | ## Installation ### Claude Code ```bash claude mcp add codex-swarm…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.