Home › Other › codex-octopus

codex-octopus

Spawn multiple specialized Codex agents as MCP servers, each independently configured.

TypeScript

★ 20 stars Last pushed 2026-09-23 License: ISC

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 1.0.1)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "CODEX_API_KEY": "<YOUR_VALUE>",
        "CODEX_TOOL_NAME": "<YOUR_VALUE>",
        "CODEX_MODEL": "<YOUR_VALUE>",
        "CODEX_SANDBOX_MODE": "<YOUR_VALUE>",
        "CODEX_APPROVAL_POLICY": "<YOUR_VALUE>",
        "CODEX_APPEND_INSTRUCTIONS": "<YOUR_VALUE>",
        "CODEX_FACTORY_ONLY": "<YOUR_VALUE>"
      }
    }
  }
}

CODEX_API_KEY secret — OpenAI API key (leave unset to inherit from parent process)
CODEX_TOOL_NAME — Tool name prefix (default: codex)
CODEX_MODEL — Model: gpt-5-codex, o3, codex-1, or full ID
CODEX_SANDBOX_MODE — Sandbox: read-only, workspace-write, danger-full-access
CODEX_APPROVAL_POLICY — Approval: never, on-failure, on-request, untrusted
CODEX_APPEND_INSTRUCTIONS — Additional instructions appended to the default
CODEX_FACTORY_ONLY — Set to true to expose only the factory wizard tool