Agent Integrations overview
Engram supports two integration layers:
- Skill files — generated instructions for agents that read project context.
- Slash adapters — generated
/engramcommand prompts for agents that support project slash commands or Agent Skills. - MCP-style tools — a JSON-lines wrapper for agents that can register external tool processes.
- Agent hooks — opt-in host hooks that inject routed Engram context at session start and later task-change turns.
Quick start
engram inject
engram link all
engram link all installs the public target set and reports deterministic SKIPPED reasons for partial hosts across skillset instruction files, MCP config, slash adapters, and agent hooks in one unified install.
Target categories
| Category | Targets | Behavior |
|---|---|---|
| Runtime-first | codex, claude, cursor, gemini | Short bootstrap instructions, a companion guide with the full workflow, short Agent Skill pointers, and MCP config |
| Hook-capable | codex, claude, gemini, opencode, cursor, windsurf/cascade | Agent hooks with host-specific event schemas |
| Compact/manual fallback | agents-md, copilot, cline | Full compact protocol; no reliable runtime context injection in v1 |
Supported targets
| Target | File | Main use |
|---|---|---|
codex | AGENTS.md, .agents/skills/engram/SKILL.md | OpenAI Codex project instructions and Agent Skill |
agents-md | AGENTS.md | Generic fallback for unlisted AGENTS.md-compatible agents |
copilot | .github/copilot-instructions.md; global: ~/.copilot/copilot-instructions.md | GitHub Copilot repository and user instructions |
claude | AGENTS.md, .claude/engram.md, .agents/engram.md, plus a CLAUDE.md block only when that file already exists, and .claude/rules/engram/<id>.md path rules | Claude Code project guidance and native path rules |
cursor | .cursor/rules/engram.mdc, .cursor/rules/engram/<id>.mdc path rules; global: ~/.cursor/plugins/local/engram/ | Cursor project rules, native path rules, and local plugin |
gemini | GEMINI.md; global: ~/.gemini/GEMINI.md, ~/.gemini/skills/engram/SKILL.md | Gemini CLI context, including Antigravity Gemini-compatible surfaces |
cline | .clinerules | Cline-style workspace rules |
windsurf | .windsurf/rules/engram.md; global: ~/.codeium/windsurf/memories/global_rules.md | Windsurf workspace rules and global rules/MCP |
opencode | AGENTS.md, .opencode/engram.md, .opencode/skills/engram/SKILL.md, opencode.json | OpenCode rules, Agent Skill, MCP tools, custom commands, plugin hooks |
mcp | .mcp.json; global: ~/.gemini/settings.json, ~/.codex/config.toml, and a claude mcp add hint | MCP-style JSON-lines wrapper registration |
slash | .claude/commands/engram.md, .cursor/commands/engram.md, .gemini/commands/engram.toml, .opencode/commands/engram.md | Native /engram slash adapters |
Aliases: codex installs the agents-md adapter plus the generic Agent Skill file, open-code maps to opencode, and cascade maps to windsurf. The old antigravity and antigravity-cli targets are hidden compatibility aliases for now.
Hook capability matrix
| Host | Hook install in v1 | Events |
|---|---|---|
codex | Yes | SessionStart, UserPromptSubmit, PreToolUse, PreCompact, SubagentStart |
claude | Yes | SessionStart, UserPromptSubmit, InstructionsLoaded (PreToolUse with hooks.path_rules hook), PreCompact, SubagentStart |
gemini | Yes | SessionStart, BeforeAgent, AfterTool, PreCompress |
cursor | Yes | sessionStart |
windsurf / cascade | Yes | pre_user_prompt |
opencode | Supported via local plugin | chat.message, experimental.chat.system.transform |
copilot | Skipped | N/A |
cline | Skipped | N/A |