Codex Octopus

xiaolai/codex-octopus

If you need to run multiple Codex instances with different personalities and permissions, this is the wrapper for you. It lets you spin up specialized agents from a single binary, each configured independently via environment variables. You might run a strict code reviewer locked to read-only sandbox, a test writer with workspace-write access, and a quick helper on minimal effort, all appearing as separate tools in your MCP client. It wraps the OpenAI Codex SDK and exposes a task tool plus a reply tool for threading conversations. There's also a factory mode that generates configuration snippets interactively. Useful when one general-purpose Codex isn't enough and you want purpose-built agents without managing separate installations.

GitHub stars

14

tool

1

auth

Secret needed

transport

STDIO

env vars

7

last updated

Apr 2, 2026

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

npm install codex-octopus