Using with Codex

Codex reads its MCP config from ~/.codex/config.toml. It is the only one of the five supported editors that uses TOML instead of JSON. codehub setup writes the correct TOML block for you.

Wire the MCP server

write ~/.codex/config.toml

codehub setup --editors codex

The writer merges a [mcp_servers.codehub] table into the existing TOML without touching other tables.

Prerequisite: codehub must be on your PATH — run mise run cli:link from a checkout, or mise run cli:install-global to install the packed tarball. See Install.

The resulting block looks like:

~/.codex/config.toml

[mcp_servers.codehub]
command = "codehub"
args = ["mcp"]

Restart Codex after the first write so it picks up the new server. Codex spawns the server over stdio and keeps it alive for the session.

Fallback for unlinked checkouts

If you cannot put codehub on PATH, point Codex at the CLI’s dist/ entrypoint instead — same behaviour, longer path:

~/.codex/config.toml (fallback)

[mcp_servers.codehub]
command = "node"
args = ["/abs/path/to/opencodehub/packages/cli/dist/index.js", "mcp"]

Multi-editor setup

--editors accepts any comma-separated subset of claude-code,cursor,codex,windsurf,opencode. The default is all five.

wire Codex alongside Claude Code

codehub setup --editors codex,claude-code

Reverting

remove only the codehub entry

codehub setup --editors codex --undo

--undo removes only the [mcp_servers.codehub] table. Other Codex MCP servers are left alone.

Next

• MCP tools — the catalogue of 29 tools Codex will see.