Codex

Open Knowledge plugs into Codex through MCP.

Install

There are two ways to connect Codex, depending on how you run Open Knowledge:

• macOS desktop app. The first time you open a project, a consent dialog detects Codex and configures it for you. To re-trigger the dialog, delete ~/.ok/mcp-status.json and relaunch.
• Web app / terminal (Linux, Intel Mac — see the web app guide). Run ok init in your project: it registers the Open Knowledge MCP server with Codex and the other editors it detects. Every ok start refreshes the entry.

Open with AI

From the editor, Open with AI ▸ Codex dispatches the current file, folder, or project to Codex in one click. Three entry points: the editor header's sparkle icon, the sidebar's right-click menu (file / folder / empty space), and the macOS File → Open with AI menu.

Codex receives a short prompt asking it to open the target in Open Knowledge's web preview. The agent then grounds the rest of the conversation through MCP. See Editor → Open with AI for the full UX.

Verify

Open the project in Codex and ask:

“List the first 5 documents you come across in this project.”Copy

The agent should call the Open Knowledge exec tool and respond with some of your documents.

If you don't see the tool, restart Codex.