Skip to main content
Codex has native Cekura plugin support. The plugin gives you Cekura Skills and the Cekura MCP server — you just authenticate the MCP once.

Install the plugin

Three commands — add the marketplace, install the plugin, then authenticate MCP:
codex plugin marketplace add cekura-ai/cekura-skills
codex plugin add cekura@cekura
codex mcp login cekura
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 it worked:
codex plugin list   # cekura listed as installed
codex mcp list      # cekura shows connected after login
Added the marketplace before a recent release? Refresh it first: codex plugin marketplace upgrade cekura. For API-key auth instead of OAuth, see API-key setup.

Verify setup

Start Codex from your agent repo and ask:
Use the Cekura skills and MCP. List my Cekura agents, pick one, and propose 3 evaluators I should create first. Do not create anything until I approve.
Codex should list real agents from your workspace and reason in Cekura terms (evaluators, metrics, test profiles, run results).

No plugin?

Set up Skills + MCP manually, or use the behavior preset fallback.
1

Run Codex from the agent repo

Codex should have access to prompts, tool definitions, schemas, and local tests before it creates Cekura evaluators.
2

Plan first, then create

Ask Codex for a coverage matrix. Approve the plan before creating evaluators or metrics.
3

Run a small test batch

Run a small set of evaluators first, inspect transcripts, then scale to broader regression runs.
4

Patch and re-run

When a run fails, ask Codex to compare the transcript against your prompt or code, patch the likely issue, and rerun the targeted evaluator.

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 marketplace upgrade cekura
codex plugin add cekura@cekura
Confirm with codex plugin list — the cekura@cekura row should show the new version.

Auto-update (optional)

The plugin ships a SessionStart 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

Run codex plugin marketplace upgrade cekura, then codex plugin add cekura@cekura again. Confirm with codex plugin list.
Run codex mcp login cekura and confirm codex mcp list shows cekura connected. Restart Codex if needed.
Re-run codex mcp login cekura and confirm your browser is signed into the correct Cekura account.