vc-agent-teams

You can coordinate Codex agent teams by using a file-based mailbox protocol that manages team creation, member addition, direct messaging, and broadcasts. This provides explicit lifecycle control and persistent communication for collaborative workflows.

A file-based mailbox protocol utilizes file-backed JSON inboxes to enable persistent communication between agents. It supports direct messages, broadcasts, and shutdown or plan approval requests, ensuring coordinated progress and clear communication.

To set up an agent team, use the team creation command to initialize a group, add members, and assign tasks via their respective mailboxes. For example, a lead agent can assign tasks to a researcher and a coder within a newly created team.

Yes, the multi-agent coordination system supports both direct messaging and broadcasts. It also includes request-response safety mechanisms and message pruning to maintain efficient and clear communication across the team.

Plan approval and shutdown are managed through explicit lifecycle control workflows. Agents can send plan approval requests via the mailbox protocol, and the system handles shutdown sequences to safely terminate coordinated tasks.

The file-backed JSON inbox system includes message pruning to manage efficiency, but it is fundamentally designed for Codex-native agent teams. It may not be suitable for non-Codex platforms or workflows requiring real-time, non-file-based messaging protocols.