# Oracle Codex Memory

> Use when a Codex session should recall, write, seed, inspect, or delete curated Oracle-backed memory through the oracle-codex-memory MCP sidecar.

- Skill: `acedergren/oracle-codex-memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add acedergren/oracle-codex-memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/acedergren/oracle-codex-memory/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: acedergren (https://skillmd.com/u/acedergren)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/acedergren/oracle-codex-memory

---


# Oracle Codex Memory

Use this skill when working with repo/session memory that should be backed by
Oracle Agent Memory through the local `oracle-codex-memory` FastMCP sidecar.

## Operating Rules

- Recall before major repo work when prior context may matter.
- Write only curated facts: decisions, repo conventions, command fixes, error
  patterns, summaries, and seed-pack entries.
- Do not store raw command output unless the runtime explicitly allows it.
- Treat `OCM_USER_ID` and `OCM_AGENT_ID` as server-side scope. Do not trust
  caller-supplied scope overrides.
- Prefer `record_command_result` for long or sensitive logs so output is
  compacted and redacted before persistence.
- Use `delete_memory_capture` for correction or retention cleanup.

## Common Flow

1. Call `memory_health_check`.
2. Call `start_coding_session` with the workspace path and thread id.
3. Call `recall_context` before changing durable project behavior.
4. Call `remember_decision` only after a decision is clear and reviewed.
5. Call `record_command_result` for useful failures, fixes, or verification
   evidence.
6. Call `summarize_session` near handoff when the summary is worth retaining.

## Local Setup

See `docs/user-guide/quickstart.md` for plugin installation and environment
variables, and `docs/admin/local-oracle-free.md` for local Oracle AI Database
Free Lite setup.