# Codex CLI Adapter

Use this adapter when installing the TimeBack Ed-Fi 1EdTech skill into Codex CLI.

## Install

```bash
export ED_FI_SKILL_PACK_URL="${ED_FI_SKILL_PACK_URL:-https://platform3-andymontgomery-9773s-projects.vercel.app/ed_fi/1edtech/skill_pack}"
export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export ED_FI_SKILL_DIR="$CODEX_HOME/skills/timeback-ed-fi-1edtech"
mkdir -p "$ED_FI_SKILL_DIR/agents" "$ED_FI_SKILL_DIR/references" "$ED_FI_SKILL_DIR/bin"

curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/SKILL.md" -o "$ED_FI_SKILL_DIR/SKILL.md"
curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/agents/openai.yaml" -o "$ED_FI_SKILL_DIR/agents/openai.yaml"
curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/agents/codex-cli.md" -o "$ED_FI_SKILL_DIR/agents/codex-cli.md"
curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/agents/claude-code.md" -o "$ED_FI_SKILL_DIR/agents/claude-code.md"
curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/agents/perplexity-computer.md" -o "$ED_FI_SKILL_DIR/agents/perplexity-computer.md"
curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/bin/proof-replay.sh" -o "$ED_FI_SKILL_DIR/bin/proof-replay.sh"
chmod +x "$ED_FI_SKILL_DIR/bin/proof-replay.sh"

for file in source-contract worked-example app-build-protocol auth-and-headers leak-check; do
  curl -fsSLL "$ED_FI_SKILL_PACK_URL/pack/references/$file.md" -o "$ED_FI_SKILL_DIR/references/$file.md"
done
```

## Codex Usage

Ask Codex to use `$timeback-ed-fi-1edtech` when building attendance, grades, discipline, transcript, program, staff, calendar, import/export, or conformance deliverables on the Ed-Fi 1EdTech surface.

Before final output, Codex should run:

```bash
"$ED_FI_SKILL_DIR/bin/proof-replay.sh"
```

The script is a proof replay only: it calls the public demo surface and checks returned values. It is not an Ed-Fi schema parser, descriptor table, ETag calculator, idempotency replay cache, or soft-delete implementation.