AGENTS.md

Use this workflow inside Codex Cloud for this project.

Primary loop

1. Make code changes under the addon root.
2. Package the current in-progress addon snapshot:

   python codex/upload_snapshot.py --addon-root "$ADDON_ROOT" --module-name "$ADDON_MODULE"
   

3. Submit a Blender sandbox job:

   python codex/submit_job.py --snapshot-id <SNAPSHOT_ID> --wait
   

4. Inspect result.json, logs, screenshots, and clips.
5. Iterate until the result is green.

Rules

• Do not assume branch head equals the addon state under test.
• Always run against a snapshot created from the current working tree.
• Prefer artifact-driven validation over live viewer dependency.
• Use the viewer only when a human needs to confirm viewport/UI behavior.
• Avoid adding new network destinations without updating the Codex environment allowlist.