Skip to content

Codex & Other Clients

Codex and other MCP clients use Rook’s MCP tools. The curated skill workflow ships to Claude Code via the marketplace plugin and to Codex via the installer (the same 11 user skills). Maintainer/dev-only skills ship to neither client.

ClientMCP toolsSkillsSession hook
Codex CLI✅ (curated, 11; installer-delivered)
Cursor
Windsurf
Any MCP client

Hooks and Claude Code plugins remain Claude-only.

Run the Rook installer — it sets up the Rhino plug-ins, the local MCP server, generates a user-level ~/.codex/config.toml, and copies the curated 11 user skills to ~/.codex/skills. It also installs AGENTS.md with Rook’s operating guidance. No extra step needed for skills. See Install Rook.

Add this to ~/.codex/config.toml:

[mcp_servers.rook]
command = "<path-to-python>"
args = ["-m", "rook"]
cwd = "<path-to-mcp_server-directory>"
[mcp_servers.rook.env]
PYTHONPATH = ""
PYTHONHOME = ""
ROOK_INSTALL_ROOT = "<install-root>"
ROOK_DATA_DIR = "<data-directory>"
ROOK_MODE = "release"

Use the same placeholder values as the Claude Code release table.

Codex also reads an AGENTS.md file (the Codex counterpart to CLAUDE.md), installed to %LOCALAPPDATA%\Rook\AGENTS.md, which carries Rook’s operating guidance.

These clients support MCP servers. Add Rook using the same stdio command, args, cwd, and env shown above, in the client’s MCP configuration. You’ll get the full tool set; skills and hooks won’t be available.

Whatever the client, hand your agent the Set Up & Verify page — the MCP and Rhino checks work everywhere. (The skills check only applies to Claude Code and Codex.)