Skip to main content

Codex + Moxie Docs

MCP context for Codex - conventions before the first edit

Codex works faster when it already knows your build commands, module boundaries, and documentation gaps. Moxie Docs indexes your GitHub repository and exposes that context through MCP tools formatted for agents.

  • Compact lookups. Replace dozens of file reads with scoped MCP queries for conventions and docs.
  • Doc-impact hints. See which docs and gaps apply to the files Codex plans to change.
  • Same index as your team. Humans search the workspace; agents read it over MCP - one source of truth.

Set up Codex with Moxie Docs

  1. Step 1

    Index your repo

    Connect GitHub and run the first index on the repository Codex will edit.

  2. Step 2

    Add the MCP endpoint

    Export your token as MOXIE_DOCS_MCP_TOKEN, then run codex mcp add moxie-docs --url https://moxiedocs.com/api/mcp --bearer-token-env-var MOXIE_DOCS_MCP_TOKEN. The dashboard shows the same command with your token filled in.

  3. Step 3

    Prompt for context first

    Ask Codex to read conventions and gaps before implementing the task.

$ npx moxie-docs setup

Sign in, configure your editor, and install the skill - one command.

FAQ