# Codex CLI Install Notes

Install the QTI skill as a Codex skill:

```sh
export QTI_SKILL_URL="https://platform3-andymontgomery-9773s-projects.vercel.app/qti/1edtech/skill_pack/pack/qti-1edtech-surface"
export CODEX_SKILLS_DIR="${CODEX_HOME:-$HOME/.codex}/skills/qti-1edtech-surface"
mkdir -p "$CODEX_SKILLS_DIR/agents" "$CODEX_SKILLS_DIR/examples" "$CODEX_SKILLS_DIR/checks"
curl -fsSLL "$QTI_SKILL_URL/SKILL.md" -o "$CODEX_SKILLS_DIR/SKILL.md"
curl -fsSLL "$QTI_SKILL_URL/agents/openai.yaml" -o "$CODEX_SKILLS_DIR/agents/openai.yaml"
curl -fsSLL "$QTI_SKILL_URL/agents/codex-cli.md" -o "$CODEX_SKILLS_DIR/agents/codex-cli.md"
curl -fsSLL "$QTI_SKILL_URL/examples/assessment-app-spec.md" -o "$CODEX_SKILLS_DIR/examples/assessment-app-spec.md"
curl -fsSLL "$QTI_SKILL_URL/examples/qa-report-template.md" -o "$CODEX_SKILLS_DIR/examples/qa-report-template.md"
curl -fsSLL "$QTI_SKILL_URL/checks/qti-surface-check.sh" -o "$CODEX_SKILLS_DIR/checks/qti-surface-check.sh"
chmod +x "$CODEX_SKILLS_DIR/checks/qti-surface-check.sh"
```

Start Codex in the target app workspace and ask:

```text
Use $qti-1edtech-surface to run checks/qti-surface-check.sh, build the assessment app from examples/assessment-app-spec.md, and produce examples/qa-report-template.md as the handoff report. Use the demo tenant first; then, if QTI_REVIEWER_JWT and QTI_REVIEWER_TENANT_ID are present, repeat the proof check against the real tenant.
```

Credential rules:

- `QTI_BASE_URL` should stay pinned to the canonical hierarchical implementation URL.
- `QTI_REVIEWER_JWT`, `QTI_REVIEWER_TENANT_ID`, and `QTI_CANDIDATE_REF` must be supplied by the operator or secret store.
- Redact JWTs from command output, source files, reports, screenshots, and commits.