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. Path to a `rootCA.pem` to trust a self-signed GoodMem CA. More secure; requires copying the cert to your machine.
`NODE_TLS_REJECT_UNAUTHORIZED`	Optional. Set to `0` to disable TLS verification entirely. Easy but not recommended for production.

Set only one of the two TLS variables. 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.

You can also configure GoodMem credentials conversationally; just tell Codex your server details and it calls goodmem_configure for you (TLS variables cannot be set this way and 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.