---
name: ager-to-codex
description: Translate a validated AGER/OKF AgentGraph into a Codex plugin ($ager-run skills). Use when compiling AGER for Codex.
---

# AGER → Codex

Compile only. Authoring is `okf-agent-graph`.

## Mapping

| AGER | Codex |
| --- | --- |
| AgentGraph | `.codex-plugin/plugin.json` |
| OrchestratorAgent | skill + default prompt |
| Worker / Judge / Synthesizer | `skills/<id>/SKILL.md` |
| LoopPolicy | `$ager-run` |
| Tool + ToolRule | skill tool bullets |
| ScratchPad | listed keys only |

## Steps

1. Locate the AGER bundle.
2. Validate with `ager-validate` when available.
3. Run:

```bash
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT>
```

4. Tell the user:

```bash
codex plugin marketplace add <path-or-SpillwaveSolutions/codex-ager>
```

Then `$ager-run` inside Codex. Report written paths. Do not freehand the tree.

## References

- `references/mapping.md`