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.
Explore
- 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
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
``json``
{
"mcpServers": {
"codex": {
"command": "npx",
"args": ["codex-octopus"],
"env": {
"CODEX_SANDBOX_MODE": "workspace-write",
"CODEX_APPROVAL_POLICY": "never"
}
}
}
}
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"
}
}
}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.
