← Index

io.github.xiaolai/codex-octopus

io.github.xiaolai/codex-octopus·v1.0.1·Other
Quality Score
85
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex_api_key>",
        "CODEX_TOOL_NAME": "<codex_tool_name>",
        "CODEX_MODEL": "<codex_model>",
        "CODEX_SANDBOX_MODE": "<codex_sandbox_mode>",
        "CODEX_APPROVAL_POLICY": "<codex_approval_policy>",
        "CODEX_APPEND_INSTRUCTIONS": "<codex_append_instructions>",
        "CODEX_FACTORY_ONLY": "<codex_factory_only>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<your-codex_api_key>",
        "CODEX_TOOL_NAME": "<codex_tool_name>",
        "CODEX_MODEL": "<codex_model>",
        "CODEX_SANDBOX_MODE": "<codex_sandbox_mode>",
        "CODEX_APPROVAL_POLICY": "<codex_approval_policy>",
        "CODEX_APPEND_INSTRUCTIONS": "<codex_append_instructions>",
        "CODEX_FACTORY_ONLY": "<codex_factory_only>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y codex-octopus
§02  Environment variables
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

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Other