Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Codex

Use the verified native Codex adapter to transport TCAF Run Envelopes into repository work.

Content: completeWorkflow: verified

The Codex adapter is the recommended verified path when Codex has access to the target repository and can inspect files, apply edits and report command results.

Select Codex

Record Codex during installation or override adapter selection for a run:

python install.py --adapter codex
tcaf task --target <project> --request "<task>" --adapter codex

Automatic selection may choose Codex when the host environment exposes the expected integration.

Operating flow

  1. Generate the TCAF Run Envelope.
  2. Give the envelope to Codex with the target repository available.
  3. Let Codex inspect the pertinent project evidence.
  4. Review the proposed Task Contract before consequential edits.
  5. Authorize implementation only inside the approved surface.
  6. Review the resulting diff and evidence.
  7. Authorize reconciliation, commit or push separately.

Repository access

The target repository should be the only software workspace relevant to the run. Do not add the TCAF framework repository as a second code workspace. The installed runtime supplies instructions; the project supplies current evidence.

What remains under developer control

Codex access does not broaden TCAF authority. The developer still decides:

  • what work is delegated;
  • which files may change;
  • whether a contract is approved;
  • whether commands may run;
  • whether the result is accepted;
  • whether documentation, commit, push or pull request operations follow.

The developer may also edit the repository directly at any point. Codex must re-read and integrate those changes.

Verification status

The Codex workflow has been exercised for adoption, bounded implementation and documentation/status reconciliation. That verification does not imply that every model version, repository type or active-task condition has been tested.

When the host cannot access a required resource or execute a check, report the limitation and return READY FOR CHECK, PARTIAL or BLOCKED as appropriate instead of fabricating evidence.