whatisgithub

What is codex-team-mode?

oil-oil/codex-team-mode — explained in plain English

Analysis updated 2026-05-18

43PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Codex Skill that adds four specialized AI subagents, an explorer, two executors, and a reviewer, so a coding assistant can delegate parts of a task while keeping key decisions in the main thread.

Mindmap

mindmap
  root((codex-team-mode))
    What it does
      Coordinates four subagents
      Main thread keeps decisions
      Routing guide not pipeline
    Tech stack
      Python
      TOML profiles
      Codex Skill
    Use cases
      Delegate research
      Bounded implementation
      Independent review
    Audience
      Codex users
      Developers automating tasks

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add a coordinated team of AI subagents to a Codex coding session for larger tasks.

USE CASE 2

Delegate read-only research or investigation to an Explorer subagent while the main thread waits.

USE CASE 3

Hand off bounded implementation work to an Executor or Complex Executor with clear checks.

USE CASE 4

Get an independent, fresh-context review of finished code, plans, or reports from a Reviewer subagent.

What is it built with?

PythonTOMLCodex

How does it compare?

oil-oil/codex-team-modealibaba/omnidoc-tokenbencharccalc/dwmfix
Stars434343
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires copying five TOML agent profile files into a personal or project Codex agents folder after installing the Skill.

So what is it?

codex-team-mode is a Skill for Codex, the AI coding assistant, that adds a system of four specialized subagents for handling large development, research, analysis, planning, document, data, and content tasks. Instead of one assistant doing everything alone, the main conversation thread can hand off pieces of work to these subagents, while keeping the important decisions and final verification for itself. The four roles are named Explorer, Executor, Complex Executor, and Reviewer. Explorer only reads and gathers information from web sources, documents, code, APIs, logs, and configuration files. Executor handles clear, bounded, low risk work with checks that can be verified automatically. Complex Executor takes on larger implementation tasks once the architecture and safety boundaries are already understood. Reviewer independently checks finished code, plans, reports, or other results from a fresh perspective, without seeing the earlier conversation. Every subagent must be explicitly assigned one of these four roles, and a separate guard rejects any attempt to spawn a subagent without doing so. The tool is described as a routing guide rather than a required pipeline, it can decide to use no subagents at all if delegating them would add more coordination overhead than benefit. The documentation gives detailed rules for when delegation is worthwhile, how to write clear instructions for each subagent, and how to avoid duplicate work or unclear task handoffs. Installation is done by adding the Skill through a package command, then copying five provided configuration files into a personal or per project folder so Codex can find the four agent profiles. Users can customize which underlying model and reasoning effort level each subagent role uses, while the boundaries between read only and mutation capable roles stay fixed. The project is written primarily in Python for its supporting scripts and tests, and is released under the MIT License.

Copy-paste prompts

Prompt 1
Walk me through installing codex-team-mode and setting up the four agent profiles.
Prompt 2
Explain the difference between the Executor and Complex Executor roles in this project.
Prompt 3
Show me how to write a dispatch packet so a subagent has everything it needs to complete a task.
Prompt 4
How do I customize the model and reasoning effort for each subagent role in agents/*.toml?

Frequently asked questions

What is codex-team-mode?

A Codex Skill that adds four specialized AI subagents, an explorer, two executors, and a reviewer, so a coding assistant can delegate parts of a task while keeping key decisions in the main thread.

What language is codex-team-mode written in?

Mainly Python. The stack also includes Python, TOML, Codex.

How hard is codex-team-mode to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is codex-team-mode for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.