Codex Install

Switchboard can run as a stdio MCP server behind Codex. The CLI defaults to a dry-run snippet and can write project-scoped Codex config when you pass --write.

Dry Run

switchboard status
switchboard doctor
switchboard install codex

The generated snippet targets ~/.codex/config.toml or project-local .codex/config.toml:

[mcp_servers."switchboard"]
command = "switchboard"
args = ["--cwd", "/path/to/your/repo", "mcp"]
cwd = "/path/to/your/repo"
startup_timeout_sec = 20
tool_timeout_sec = 60

For JSON automation:

switchboard install codex --json

Write Project Config

Write .codex/config.toml for the current repo:

switchboard install codex --write

If .codex/config.toml already exists, Switchboard creates a timestamped backup next to it before writing. Restore one with:

switchboard install codex --rollback .codex/config.toml.switchboard-backup-<timestamp>

Codex also supports registering stdio MCP servers with its CLI:

codex mcp add switchboard -- switchboard --cwd /path/to/your/repo mcp

After installing, run /mcp inside Codex to verify the server is listed.

For debugging without the daemon-backed adapter, run switchboard --cwd /path/to/your/repo serve.

Reference: https://developers.openai.com/codex/mcp