@nexus-catalyst/codex-plugin

Automatic memory for Codex CLI. Nexus-Catalyst recalls relevant context from your past sessions so the model starts warm.

How it works

Codex CLI has no per-turn pre-prompt hook usable for recall, so this plugin wires memory two ways:

1. An AGENTS.md recall rule (rules/nexus-catalyst-memory.md) that instructs the model to call NC's recall_context at the start of a task and store_context at the end — recall is MCP-driven.
2. Streamable-HTTP MCP configuration so Codex can reach the NC server.

See _docs/codex-support.md for the config format (config.toml) and the current limits of Codex's hook lifecycle.

Prerequisites

• Node.js 18+
• A Nexus-Catalyst account — sign up at nexus-catalyst.com
• A Plugin API key from app.nexus-catalyst.com → Account → API Keys

Install

npm install -g @nexus-catalyst/codex-plugin
nc-codex install

Verify:

nc-codex status

Commands

nc-codex install       Install the NC AGENTS.md rule + MCP wiring
nc-codex uninstall     Remove NC entries (nothing else is touched)
nc-codex status        Show installation state
nc-codex print-config  Print the [mcp_servers] block for config.toml

install prints an [mcp_servers.nexus-catalyst] block to add to ~/.codex/config.toml. Add it verbatim — including default_tools_approval_mode = "approve". Without that key Codex defaults to "prompt", and codex exec has nobody to prompt, so every memory call is auto-denied. Interactive runs still work, which is what makes the omission easy to miss.

Configuration

One key works across all NC tool plugins. It is read from NC_PLUGIN_API_KEY or ~/.nexus-catalyst/config.json (shared — set it once with any plugin's set-key).

NC_API_BASE_URL overrides the endpoint (default https://mcp.nexus-catalyst.com).

License

MIT — see LICENSE. Part of the Nexus-Catalyst/cli-hooks monorepo. The memory service requires an NC account.