Agent Guides · Advisory Hour Note

Run Codex Like a Project Team

A compact operating pattern for Visual Studio Code: organize the work like a project, then let separate Codex chats run in parallel while you supervise progress.

Originally published as an Advisory Hour Substack note. Subscribe there for the latest essays, notes, and frontier work.

The note

In Visual Studio Code while using Codex, organize the work like a project and then set your agents off to work. Each new chat sends the prior chat into the background. From there it’s just like checking on a team of developers and their work in progress.

Why this matters

The trick is not only opening more agent chats. The useful shift is treating each chat like a scoped contributor with a clear job, a place in the project, and a status you can check without collapsing the whole effort back into one giant thread.

That turns Codex from a single assistant into a lightweight development floor. The human role becomes project lead: break work into coherent pieces, inspect what each agent produced, catch drift early, and merge the parts that actually fit.

Operating pattern

Structure the work before multiplying agents

  • 1 · Name the project shape
    Write down the goal, key files, acceptance criteria, and likely workstreams before starting parallel chats.
  • 2 · Give each chat one lane
    Send one Codex chat after implementation, another after tests, another after review, or split by module when the boundaries are clean.
  • 3 · Check progress like a lead
    Revisit background chats for status, diffs, blockers, and evidence. Do not assume output is ready just because a chat completed.
  • 4 · Merge with judgment
    Use the human pass to reconcile conflicts, keep the source of truth coherent, and reject work that only looks plausible.

Simple setup checklist

  • Define the outcome in one sentence.
  • Split the work into 2–4 lanes that can be inspected independently.
  • Give each Codex chat a concrete target and a verification requirement.
  • Keep a visible project note with lane status: planned, running, needs review, merged, blocked.
  • Run the final integration and test pass from one source of truth.

Related thread