Install the plugin
Three commands — add the marketplace, install the plugin, then authenticate MCP:codex mcp login opens a browser for OAuth sign-in — no API key. Prefer the TUI? Run codex, open /plugins to install cekura, then /mcp to authenticate.
Codex plugins don’t carry slash commands; the bundled Skills cover those workflows — they activate by context or when you invoke one with
@.Verify setup
Start Codex from your agent repo and ask:No plugin?
Set up Skills + MCP manually, or use the behavior preset fallback.Recommended workflow
Run Codex from the agent repo
Codex should have access to prompts, tool definitions, schemas, and local tests before it creates Cekura evaluators.
Plan first, then create
Ask Codex for a coverage matrix. Approve the plan before creating evaluators or metrics.
Run a small test batch
Run a small set of evaluators first, inspect transcripts, then scale to broader regression runs.
Keep it updated
Re-run both commands to pull the latest version —marketplace upgrade only refreshes the snapshot, and plugin add re-pins the installed plugin to it (running just the first leaves you on the old version):
codex plugin list — the cekura@cekura row should show the new version.
Auto-update (optional)
The plugin ships aSessionStart hook that runs the two commands above automatically on each launch (throttled to once/day). Codex requires you to trust the hook once: run codex, open /hooks, and trust the Cekura SessionStart hook. After that it’s automatic — the manual commands still work to force an update immediately.
Troubleshooting
Plugin not found or out of date
Plugin not found or out of date
Run
codex plugin marketplace upgrade cekura, then codex plugin add cekura@cekura again. Confirm with codex plugin list.MCP tools do not appear
MCP tools do not appear
Run
codex mcp login cekura and confirm codex mcp list shows cekura connected. Restart Codex if needed.OAuth does not complete
OAuth does not complete
Re-run
codex mcp login cekura and confirm your browser is signed into the correct Cekura account.