Skip to main content

Codex

OpenAI Codex and other AGENTS.md-compatible agents use AGENTS.md as a project instruction file. The codex alias also writes .agents/skills/engram/SKILL.md so agents that discover Agent Skills can route Engram as an invokable skill.

Install

engram link codex

Files written

FilePurpose
AGENTS.mdProject instructions bootstrap
.agents/skills/engram/SKILL.mdAgent Skill with full write/approval workflow
.codex/hooks.jsonSessionStart and UserPromptSubmit hooks
.mcp.jsonMCP registration

Global install

engram link --global codex

Writes the Codex skill to ~/.codex/skills/engram/SKILL.md and appends a managed block to shared Codex instruction files.

Hook behavior

Codex supports startup and prompt-time additional context injection. SessionStart loads routed memory at startup; UserPromptSubmit reinjects only when routed Engram context changes.

Runtime-first target

Codex is a runtime-first target. AGENTS.md contains short bootstrap instructions that rely on MCP tools and hooks for detailed protocol; the Agent Skill file carries the full write/approval workflow.

Next steps