Skip to main content

Codex + UnfoldAI

Keep the project open in VS Code with UnfoldAI while Codex works. Use saved-work summaries, checkpoints and verification prompts to keep the next step focused.

Review saved work​

  1. Create a checkpoint before a risky edit.
  2. After Codex saves a change, open Command → Work Brief and inspect the work.
  3. Choose Analyze current work for an optional AI explanation, or use Copy agent brief when a useful follow-up is available. Paste the brief into Codex and ask it to investigate.
  4. Ask Codex to run the relevant checks. Review their output and use Precommit to inspect the Git diff before committing.

When more than one agent is working, By agent and Toolbox → Activity help you review their activity. Mixed or Unattributed labels simply mean the contributor is unclear. See Agents and attribution.

Connect a supported Codex client​

  1. Open Toolbox → Connect your agent and choose Codex.
  2. Follow the setup for your client and complete any confirmation shown in Codex.
  3. Keep one trusted local project folder open in VS Code. Check for a connection and a successful tool result using the MCP setup guide.

Try asking Codex:

“Use UnfoldAI to summarize changes since my checkpoint and suggest a focused verification step.”

Sharing project context needs separate permission. Checkpoint creation follows your approval settings; restore requests open human review in VS Code.

Example: Codex’s client task​

Claude Code has moved an import API to background jobs. In this illustrative scenario, ask Codex to review that change before adding retries:

“Reuse the request key for retries of the same import, follow its job to completion, and test acceptance → lost response → retry → completion. Assert that one job is created, then report the actual client result.”

Review the Work Brief example for both agents’ tasks. Copy the relevant instructions to each agent, then review their checks before continuing.