Codex Octopus
About
One brain, many arms. Spawn multiple specialized Codex agents as MCP servers via the OpenAI Codex SDK. Each instance gets its own model, sandbox, effort, and personality.
Details
- Author
- xiaolai
- Downloads
- 335
- Categories
- Other
Jump to
- Run several agents with different configurations simultaneously
- Override model, sandbox, effort, approval policy, and cwd per invocation
- Follow up on previous conversations via the _reply tool
- Generate .mcp.json configs interactively with the factory wizard
- Sandbox and approval modes only tighten per invocation for security
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Codex OctopusCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure it in your MCP client with the command npx codex-octopus and set environment variables like CODEX_SANDBOX_MODE and CODEX_APPROVAL_POLICY. You can also use the factory wizard to generate .mcp.json configs interactively.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"codex octopus": {
"codex": {
"command": "npx",
"args": [
"codex-octopus"
],
"env": {
"CODEX_SANDBOX_MODE": "workspace-write",
"CODEX_APPROVAL_POLICY": "never"
}
}
}
}
}McpServers
{
"codex": {
"command": "npx",
"args": [
"codex-octopus"
],
"env": {
"CODEX_SANDBOX_MODE": "workspace-write",
"CODEX_APPROVAL_POLICY": "never"
}
}
}Codex Octopus
One brain, many arms. An MCP server that wraps the OpenAI Codex SDK, letting you run multiple specialized Codex agents — each with its own model, sandbox, effort, and personality — from any MCP client.Why
Codex is powerful. But one instance does everything the same way. Sometimes you want a strict code reviewer in read-only sandbox. A test writer with workspace-write access. A cheap quick helper on minimal effort. A deep thinker on xhigh. Codex Octopus lets you spin up as many of these as you need. Same binary, different configurations.Quick Start
``json
{
"mcpServers": {
"codex": {
"command": "npx",
"args": ["codex-octopus"],
"env": {
"CODEX_SANDBOX_MODE": "workspace-write",
"CODEX_APPROVAL_POLICY": "never"
}
}
}
}
`
Key Features
- Multi-instance — run several agents with different configs simultaneously
- Per-invocation overrides — model, sandbox, effort, approval policy, cwd
- Session continuity — follow up on previous conversations via _reply tool
- Factory wizard — generate .mcp.json` configs interactively
- Security narrowing — sandbox and approval can only tighten per invocation
Links
- GitHub - npm - License: ISCSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
