<!-- enhance-docs page=setup/codex -->
<!-- enhance-docs release-sha256=dad2e0623acc56ece15d04a4baaff3f1e1f36c2114941c9e110479ef18927c25 -->

# Codex

![The Enhance dashboard with Codex selected and the copy setup prompt action visible.](/docs/setup/images/codex.jpg)

## Desktop app

Enhance's public OpenAI listing is still being prepared. You can install the complete local plugin from the [Enhance catalogue](https://github.com/enhance-labs-builds/enhance-plugin-dev) in the meantime. Its bundled runtime requires Node.js 24 or later.

1. In Enhance, select **Codex** and copy the setup prompt into the desktop app.
2. Open the **Plugins Directory** in the ChatGPT desktop app while using Codex or Work mode.
3. Choose the Enhance catalogue, select **Enhance**, and install it for your user account.
4. Enable the plugin and let Codex start its version-pinned MCP server. Restart the app if the install surface asks you to refresh.
5. Ask Codex to check Enhance status. Complete browser sign-in when it opens.
6. Verify the connection with a read-only request, then ask Codex to inspect and render your example canvas.

The setup prompt identifies Enhance's public Git catalogue. Add that catalogue before looking for Enhance in the directory.

## Codex extension in VS Code or Cursor

The Codex IDE extension supports MCP servers but does not support plugins. Configure Enhance within the Codex extension:

1. Open Codex's gear menu and select **MCP servers**.
2. Select **Add server**, name it `enhance`, and choose **Streamable HTTP**.
3. Enter `https://api.enhance3.karunalabs.ai/mcp`, save, and select **Restart extension**.
4. Select **Authenticate** beside Enhance and complete browser sign-in.
5. Ask Codex to list your canvases and render one.

This connects remote canvas operations without installing the four local workflow skills. Local build publication and source reconciliation need the complete local plugin. The host editor's own MCP settings configure its native agent separately.

These steps follow [OpenAI's MCP setup documentation](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

## Updates

Git-backed Codex plugins are cached by version and upgraded explicitly. When Enhance reports an update, open the Enhance catalogue, choose **Upgrade marketplace**, refresh Enhance, and re-check connection status.

## Scope

User scope is the default. Use project scope only when a team intentionally wants the plugin configuration governed with that repository.
