Codex CLI / Setup

Connect Codex, then compare agents.

Use your existing Codex installation and account. AuraMatrix’s public queries need no AuraMatrix login, API key or OAuth.

1. Start Codex with a connection for this session

codex -c 'mcp_servers.auramatrix_candidate.url="https://candidate-index.auramatrix.ai/mcp"'

2. Check the loaded tools, then ask in Codex

Use AuraMatrix to compare mini-SWE-agent and OpenHands for coding. Explain their intended use, setup, costs and permissions. Include sources, links and anything that still needs checking. Only look up information; don't install or run either agent.

From connection to your first answer

Check your client. Run codex --version and codex mcp get auramatrix_candidate. If that name already exists, check its purpose and address before overriding it in this session.
Start a fresh session. Run the copied command in your intended project. The -c override applies only to this invocation; it does not write to your saved MCP configuration. It does not add tools to a conversation already running.
Check discovery. Open /mcp in Codex and inspect AuraMatrix’s available tools. A saved URL alone is not proof of a loaded connection.
Ask the first question. Send the copied prompt. Codex should use native AuraMatrix tools and return source and comparison links. A shell HTTP request or an answer from memory is not a native query.
Read the same facts on the web. Open the returned links and compare the listing IDs, record version, source dates, pricing unknowns and permissions. Open this comparison →

Codex CLI compatibility details

Codex CLI 0.155.1 · tested 2026-09-20. Native tool discovery, search, listing details and comparison with anonymous, read-only access, using this directory version.

Tested endpoint: https://candidate-index.auramatrix.ai/mcp

This check used the public HTTPS endpoint. This is a software CLI check, not a graphical client or user acceptance test.

Evidence SHA-256: a87058c43502d55a735a86be23993e9a036534af3f3ac3793d5d6227b274b0de

Other clients, graphical interfaces, OAuth and business writes have not been tested by this check. Your client’s account and model usage terms still apply.

Save a connection for future sessions

This is optional. Codex’s MCP command writes a user-level connection to its configuration (normally ~/.codex/config.toml, or your configured Codex home). This is different from Claude Code’s project-local scope. Check existing configuration before adding a same-name entry.

codex mcp add auramatrix_candidate --url https://candidate-index.auramatrix.ai/mcp

Start a new Codex session and check /mcp again. Project MCP configuration is also supported by Codex in trusted projects; it is not required for this session-only setup.

Tool names and acceptance examples

The service exposes four read-only tools: search_catalog, get_catalog_entry, compare_catalog_entries and the existing compare_deployment_options. Listing queries use stable IDs and do not execute the listed projects.

search_catalog: {"kind":"agent","scenario":"development"}
get_catalog_entry: {"id":"agent_mini-swe-agent"}
compare_catalog_entries: {"ids":["agent_mini-swe-agent","agent_openhands"]}

Remove the connection

For the session-only command, exit that session and start Codex without the override. There is no saved connection to remove.

If you used the optional saved connection, check its name, then run:

codex mcp remove auramatrix_candidate

Start a new session to confirm it is no longer loaded.

If tools are missing

Confirm the endpoint is https://candidate-index.auramatrix.ai/mcp, start a fresh session and check /mcp. Keep any displayed error. Do not weaken permissions, reinstall, or substitute shell requests to claim success. Use the web directory while diagnosing the specific client error.

This guide covers Codex CLI public reads. Codex IDE, desktop, ChatGPT, OAuth and business writes are separate, unverified integrations. Public searches do not publish requests. Official Codex MCP documentation