English | 한국어 | 日本語 | 中文 | Deutsch | Français

Looking for Claude Code? → my-claude — same agents as Claude Code plugin with Boss meta-orchestrator

If you are an LLM agent, install directly with one command:

macOS / Linux / WSL / Git Bash

curl -fsSL https://raw.githubusercontent.com/sehoon787/my-codex/main/scripts/bootstrap.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/sehoon787/my-codex/main/scripts/bootstrap.ps1 | iex

AI-INSTALL.md remains available as the manual fallback and audit-friendly guide.

All-in-one multi-agent orchestration for OpenAI Codex CLI — install once, get everything.

Bundles 444 installed agent files (80 auto-loaded + 364 agent-packs) and 125 skills from 4 upstream sources into native TOML format. The repo currently contains 589 TOML source definitions; install-time deduplication resolves overlapping destination filenames into the final installed footprint. Codex CLI auto-discovers agents via spawn_agent and routes tasks to the optimal specialist. GitHub Actions CI syncs upstream changes weekly.

Based on the official Codex Subagents specification.

git clone --depth 1 https://github.com/sehoon787/my-codex.git /tmp/my-codex
bash /tmp/my-codex/scripts/install.sh
rm -rf /tmp/my-codex

Re-running the same bootstrap or manual install command refreshes to the latest published main build and only replaces my-codex-managed files.

Agent Packs: Domain specialist agents (marketing, sales, gamedev, etc.) are installed to ~/.codex/agent-packs/ and can be activated by symlinking to ~/.codex/agents/ when needed.

npx skills add sehoon787/my-codex -y -g

Installs 125 cross-tool skills to ~/.agents/skills/ with auto-symlinks to Codex CLI, Claude Code, Cursor, and other tools. Does not install agents, rules, or config.toml — use install.sh for the full 125-skill Codex bundle.

Install directly with one command.

macOS / Linux / WSL / Git Bash

curl -fsSL https://raw.githubusercontent.com/sehoon787/my-codex/main/scripts/bootstrap.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/sehoon787/my-codex/main/scripts/bootstrap.ps1 | iex

AI-INSTALL.md remains available as the manual fallback and audit-friendly guide.

Rerunning the same bootstrap command updates my-codex to the latest main build and refreshes managed assets in ~/.codex/.

• spawn_agent: Codex CLI auto-discovers agents from ~/.codex/agents/ and spawns them in parallel for complex tasks
• send_input: Parent-to-child agent communication for iterative workflows
• Agent Packs: Activate domain specialists on-demand via symlinks — no restart needed

• o3 (high reasoning): Complex architecture, deep analysis — mapped from Claude Opus equivalents
• o3 (medium): Standard implementation, code review — mapped from Claude Sonnet equivalents
• o4-mini (low): Quick lookups, exploration — mapped from Claude Haiku equivalents

• Install provides 444 installed agent files and 125 skills instantly
• Bundles 4 upstream sources (agency-agents, everything-claude-code, oh-my-codex, awesome-codex-subagents)
• Weekly CI auto-sync keeps bundled content up-to-date with upstream
• MD-to-TOML conversion handled automatically for non-native sources
• Installs a default git attribution flow so commits touched by real Codex sessions automatically receive AI-Contributed-By: Codex

• install.sh installs a codex wrapper plus global commit-msg and post-commit hooks in ~/.codex/git-hooks/
• The wrapper records only files that changed during a real Codex session in the current git repository
• Commits that include recorded Codex-touched files get 🤖 Generated with [Codex CLI](https://github.com/openai/codex) in the commit body
• The commit hook adds AI-Contributed-By: Codex only when staged files intersect that recorded change set
• my-codex does not change git user.name, git user.email, commit author, or committer identity
• To add an optional Co-authored-by: trailer as well, explicitly set both git config --global my-codex.codexContributorName '<label>' and git config --global my-codex.codexContributorEmail '<github-linked-email>'
• Local git commits cannot summon GitHub's official @codex agent identity directly; GitHub only recognizes co-authors by linked email, and no co-author is added unless you opt in with both settings
• To disable attribution entirely, set git config --global my-codex.codexAttribution false
• my-claude is a separate repository and is not version-managed or updated by my-codex

37 core agents providing orchestration infrastructure are installed to ~/.codex/agents/. These are the foundation agents that orchestrate, plan, review, and verify work. Domain specialists are in agent-packs. Awesome agents add additional coverage, but overlapping filenames collapse the final auto-loaded set to 80 installed files.

boss, sisyphus, atlas, hephaestus, prometheus

metis, momus, oracle, analyst, critic

executor, explore, planner, verifier, tracer, debugger

agent-organizer, multi-agent-coordinator, workflow-orchestrator, error-coordinator, task-distributor, context-manager, agent-installer, knowledge-synthesizer

writer, librarian, scientist, document-specialist, git-master

code-reviewer, code-simplifier, code-mapper, security-reviewer, architect

test-engineer, qa-tester, multimodal-looker

364 installed pack files across 21 categories are written to ~/.codex/agent-packs/ — not loaded by default. Those files come from agent-packs/, agency/, and non-core awesome categories after install-time deduplication. Activate a pack by symlinking:

# Activate a single pack
ln -s ~/.codex/agent-packs/marketing/*.toml ~/.codex/agents/

# Deactivate
rm ~/.codex/agents/<agent-name>.toml

The repository source inventory is larger than the install footprint because multiple upstreams ship the same destination filename. install.sh verifies the installed counts above, not the raw source totals.

┌─────────────────────────────────────────────────────────┐
│                    User Request                          │
└─────────────────────┬───────────────────────────────────┘
                      ↓
┌─────────────────────────────────────────────────────────┐
│  Codex CLI (spawn_agent / send_input / wait_agent)      │
│  Auto-discovers ~/.codex/agents/*.toml at runtime       │
│  Routes to optimal specialist based on task description │
└──┬──────────┬──────────┬──────────┬─────────────────────┘
   ↓          ↓          ↓          ↓
┌──────┐ ┌────────┐ ┌────────┐ ┌────────┐
│Single│ │Parallel│ │Parent- │ │Config  │
│Agent │ │Spawn   │ │Child   │ │Control │
│      │ │(multi) │ │Comms   │ │        │
│spawn │ │spawn × │ │send_   │ │config. │
│_agent│ │N       │ │input   │ │toml    │
└──────┘ └────────┘ └────────┘ └────────┘
┌─────────────────────────────────────────────────────────┐
│  Agent Layer (444 installed TOML files)                  │
│    ├── Auto-loaded (80): final installed footprint       │
│    └── Agent Packs (364): final installed footprint      │
├─────────────────────────────────────────────────────────┤
│  Skills Layer (125 from ECC)                            │
│    ├── tdd-workflow, security-review, autopilot         │
│    └── pdf, docx, pptx, xlsx, team                     │
└─────────────────────────────────────────────────────────┘

Codex CLI provides a native multi-agent protocol based on the Codex Subagents specification. The protocol defines five core operations:

Codex CLI auto-discovers all .toml files in ~/.codex/agents/ at runtime. When a task requires specialist expertise, the CLI spawns the matching agent by name and passes it the relevant context.

Every agent is defined as a native TOML file:

name = "debugger"
description = "Focused debugging specialist"
model = "o3"
model_reasoning_effort = "medium"

[developer_instructions]
content = "You are a debugging specialist..."

Key fields:

• name — Agent identifier used by spawn_agent
• description — Used for capability matching
• model — OpenAI model to use (o3, o4-mini)
• model_reasoning_effort — Reasoning level (high, medium, low)
• [developer_instructions].content — The agent's system prompt

Global multi-agent settings are defined in ~/.codex/config.toml:

[agents]
max_threads = 8
max_depth = 1

• max_threads — Maximum number of concurrent sub-agents
• max_depth — Maximum nesting depth for agent-spawns-agent chains

> Analyze the auth module for security vulnerabilities

Codex → spawn_agent("security-reviewer")
→ Agent analyzes src/auth/
→ Returns: 2 critical, 1 medium vulnerability

> Run a multi-agent pass: refactor auth, add tests, review security

Codex → spawn_agent("executor") × refactoring
      → spawn_agent("test-engineer") × test writing
      → spawn_agent("security-reviewer") × security audit
→ All 3 run in parallel (max_threads = 8)
→ Results collected and merged

> Implement payment module, then have it reviewed

Codex → spawn_agent("executor")
      → executor completes implementation
      → send_input(executor, "review needed")
      → spawn_agent("code-reviewer")
      → code-reviewer reviews executor's changes

> Plan the migration, execute it, then verify

Codex → spawn_agent("planner")
      → planner produces migration plan
      → wait_agent(planner)
      → spawn_agent("executor") with plan as context
      → executor performs migration
      → wait_agent(executor)
      → spawn_agent("verifier")
      → verifier checks all migrations applied correctly

A library of 156 business specialist agent personas. Provides specialist perspectives across 14 categories — UX architects, data engineers, security auditors, and more. Converted from Markdown to native TOML via automated md-to-toml.sh pipeline.

A development framework originally built for Claude Code, providing 125 skills. 13 Claude Code-specific skills were removed; the remaining skills contain generic coding guidance usable across any LLM agent. The rules/ directory is included in the repo as reference material but is not read by Codex CLI.

136 production-grade agents in native TOML format. Already Codex-compatible — no conversion needed. Organized across 10 categories from core development to meta-orchestration.

Codex CLI multi-agent orchestration framework by Yeachan Heo. A Rust/TypeScript runtime providing 36 skills, hooks, HUD, and team pipelines for Codex CLI. Referenced as architectural inspiration for my-codex's orchestration patterns. Does not provide agent TOML files directly.

A multi-platform agent harness by code-yeongyu. The 9 orchestration agents in this repository (atlas, hephaestus, metis, momus, oracle, prometheus, sisyphus, librarian, multimodal-looker) are adapted from omo agents, converted to Codex-native TOML format.

The official Skills Catalog for Codex provided by OpenAI. Includes specialist skills for document processing, code generation, and development workflows. Can be installed via $skill-installer in Codex CLI.

Issues and PRs are welcome. When adding a new agent, add a .toml file to the agents/ directory and update the agent list in SETUP.md. See CONTRIBUTING.md for PR validation steps and Codex commit attribution behavior.

Updated weekly by CI auto-sync. No SOURCES.json yet — versions tracked via sync-upstream.yml.

This repository builds on the work of the following open-source projects:

• agency-agents — msitarzewski
• everything-claude-code — affaan-m
• oh-my-codex — Yeachan Heo
• oh-my-openagent — code-yeongyu
• awesome-codex-subagents — VoltAgent
• openai/skills — OpenAI
• Codex Subagents Spec — OpenAI

MIT License. See the LICENSE file for details.