Skip to main content
Version: v0.9.0a2
Integrator

Stigmem in Codex CLI

Validation tier: Validated.

Codex CLI can launch stigmem-mcp as a stdio MCP server so coding sessions can read and write Stigmem facts.

Installโ€‹

npm install -g @eidetic-labs/stigmem-mcp

Configureโ€‹

Print the config snippet:

stigmem mcp config codex-cli

Apply it with backup handling:

stigmem mcp install codex-cli --write

Codex reads the global config from ~/.codex/config.toml.

Verifyโ€‹

stigmem mcp smoke codex-cli
codex mcp list

The host should expose assert_fact, query_facts, recall, resolve_contradiction, subscribe_scope, and lint_scope.

Troubleshootingโ€‹

SymptomFix
Tools not listedConfirm ~/.codex/config.toml references stigmem-mcp, then restart Codex
Auth errorsCheck STIGMEM_API_KEY
Node unavailableCheck STIGMEM_URL and the node /healthz endpoint