mgoulart/codex-subagents

5 stars · Last commit 2026-04-13

Claude Code plugin: orchestrate complex tasks with parallel Codex agents

README preview

# Codex Subagents - Claude Code Plugin

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub Stars](https://img.shields.io/github/stars/mgoulart/codex-subagents?style=social)](https://github.com/mgoulart/codex-subagents)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/mgoulart/codex-subagents/pulls)

Break complex tasks into parallel Codex agents, run them in batches, and merge the results — all from a single Claude Code slash command.

## Install

**Prerequisites:** Python 3, [uv](https://docs.astral.sh/uv/), [Codex CLI](https://github.com/openai/codex), Claude Code CLI

```bash
git clone https://github.com/mgoulart/codex-subagents.git
cd codex-subagents
./install.sh
```

The script auto-detects and installs missing dependencies, registers the MCP server, and copies the command. Restart Claude Code when done.

View full repository on GitHub →