Codex Plugin

Operate GoodMem in plain English from OpenAI's Codex CLI via bundled skills and the GoodMem MCP tools.

Stable· JavaScript/TypeScript (skills + MCP)

Overview

This plugin lets you drive GoodMem's memory infrastructure from OpenAI's Codex CLI using plain English. It bundles a set of skills (setup help, a Python SDK reference, and an MCP tools reference) alongside the GoodMem MCP server, which exposes 40+ tools for creating embedders, rerankers, LLMs, and spaces, ingesting memories from files, base64, or plain text, and running RAG and Deep Research workflows over your knowledge base.

Installation

The plugin ships with the GoodMem MCP server (npm @pairsystems/goodmem-mcp). Install the plugin into Codex from this repo:

codex plugin marketplace add PAIR-Systems-Inc/goodmem-codex-plugin

Then launch Codex, open /plugins, switch to the goodmem-codex marketplace (press / inside the browser), and install GoodMem.

An upstream PR to openai/plugins is proposed; once it lands you will be able to install GoodMem directly from the bundled Codex marketplace under the Codex official tab with no extra setup.

Configuration

Variable	Description
`GOODMEM_BASE_URL`	GoodMem server URL, e.g. `https://your-server.example.com`.
`GOODMEM_API_KEY`	GoodMem API key (starts with `gm_`).
`NODE_EXTRA_CA_CERTS`	Optional. Absolute path to the PEM certificate file for your private or self-signed CA.

The MCP server only sees variables listed under env_vars in goodmem/.mcp.json — add more there and reinstall the plugin if you need to expose additional vars. Set NODE_EXTRA_CA_CERTS before launch and restart the MCP connection after changing it. An expired or invalid server certificate must be fixed on the server.

You can also configure GoodMem credentials conversationally; just tell Codex your server details and it calls goodmem_configure for you (NODE_EXTRA_CA_CERTS must be exported in the shell before launching Codex).

Quick start

Configure credentials from chat:

> "Configure GoodMem with base URL https://my-server.com and API key gm_abc123"

Or export them before launching Codex:

export GOODMEM_BASE_URL="https://your-server.example.com"
export GOODMEM_API_KEY="gm_..."

Then ask Codex to use GoodMem in plain English, for example: "Create an embedder and a space, ingest these research papers, then answer questions across them."

Learn more

The full README, examples, and API reference live in the upstream repository: PAIR-Systems-Inc/goodmem-codex-plugin.