My Codex

[English](./README.md) | [한국어](./docs/i18n/README.ko.md) | [日本語](./docs/i18n/README.ja.md) | [中文](./docs/i18n/README.zh.md) | [Deutsch](./docs/i18n/README.de.md) | [Français](./docs/i18n/README.fr.md)

> [](https://github.com/sehoon787/my-claude) Looking for Claude Code? → my-claude — same Boss orchestration in native Claude .md agent format

---

my-codex

All-in-one agent harness for OpenAI Codex CLI. Install once, 330+ agents ready.

Boss auto-discovers every agent and skill at runtime, then routes your task to the right specialist via spawn_agent. No config. No boilerplate.

---

Installation

For Humans

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

Clone-based install:

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

Windows note:

• install.sh patches the npm-managed codex, codex.cmd, and codex.ps1 shims when they exist, so the my-codex vault pipeline still has wrapper fallback coverage even if %APPDATA%\npm resolves before ~/.codex/bin.

For AI Agents

Read https://raw.githubusercontent.com/sehoon787/my-codex/main/AI-INSTALL.md and follow every step.

---

How Boss Works

Boss is the meta-orchestrator at the core of my-codex. It never writes code — it discovers, classifies, matches, delegates, and verifies.

User Request
     │
     ▼
┌─────────────────────────────────────────────┐
│  Phase 0 · DISCOVERY                        │
│  Scan ~/.codex/agents/*.toml at runtime     │
│  → Build live capability registry           │
└──────────────────────┬──────────────────────┘
                       ▼
┌─────────────────────────────────────────────┐
│  Phase 1 · INTENT GATE                      │
│  Classify: trivial | build | refactor |     │
│  mid-sized | architecture | research | ...  │
│  → Counter-propose skill if better fit      │
└──────────────────────┬──────────────────────┘
                       ▼
┌─────────────────────────────────────────────┐
│  Phase 2 · CAPABILITY MATCHING              │
│  P1: Exact skill match                      │
│  P2: Specialist agent via spawn_agent       │
│  P3: Multi-agent orchestration              │
│  P4: General-purpose fallback               │
└──────────────────────┬──────────────────────┘
                       ▼
┌─────────────────────────────────────────────┐
│  Phase 3 · DELEGATION                       │
│  spawn_agent with structured instructions   │
│  TASK / OUTCOME / TOOLS / DO / DON'T / CTX  │
└──────────────────────┬──────────────────────┘
                       ▼
┌─────────────────────────────────────────────┐
│  Phase 4 · VERIFICATION                     │
│  Read changed files independently           │
│  Run tests, lint, build                     │
│  Cross-reference with original intent       │
│  → Retry up to 3× on failure               │
└─────────────────────────────────────────────┘

Priority Routing

Boss cascades every request through a priority chain until the best match is found:

| Priority | Match Type | When | Example | |:--------:|-----------|------|---------| | P1 | Skill match | Task maps to a self-contained skill | "merge PDFs" → pdf skill | | P2 | Specialist agent | Domain-specific agent exists | "security audit" → security-reviewer | | P3a | Boss direct | 2–4 independent agents | "fix 3 bugs" → parallel spawn | | P3b | Sub-orchestrator | Complex multi-step workflow | "refactor + test" → Sisyphus | | P4 | Fallback | No specialist matches | "explain this" → general agent |

Model Routing

| Complexity | Model | Used For | |-----------|-------|----------| | Deep analysis, architecture | o3 (high reasoning) | Boss, Oracle, Sisyphus, Atlas | | Standard implementation | o3 (medium) | executor, debugger, security-reviewer | | Quick lookup, exploration | o4-mini (low) | explore, simple advisory |

3-Phase Sprint Workflow

For end-to-end feature implementation, Boss orchestrates a structured sprint:

Phase 1: DESIGN         Phase 2: EXECUTE        Phase 3: REVIEW
(interactive)            (autonomous)             (interactive)
─────────────────────   ─────────────────────   ─────────────────────
User decides scope      executor runs tasks     Compare vs design doc
Engineering review      Auto code review        Present comparison table
Confirm "design done"   Architect verification  User: approve / improve

---

Architecture

┌─────────────────────────────────────────────────────┐
│                    User Request                       │
└───────────────────────┬─────────────────────────────┘
                        ▼
┌─────────────────────────────────────────────────────┐
│  Boss · Meta-Orchestrator (o3 high)                   │
│  Discovery → Classification → Matching → Delegation  │
└──┬──────────┬──────────┬──────────┬─────────────────┘
   │          │          │          │
   ▼          ▼          ▼          ▼
┌──────┐ ┌────────┐ ┌────────┐ ┌────────┐
│ P3a  │ │  P3b   │ │  P1/P2 │ │Config  │
│Direct│ │Sub-orch│ │ Skill/ │ │Control │
│2-4   │ │Sisyphus│ │ Agent  │ │config. │
│spawn │ │Atlas   │ │ Direct │ │toml    │
└──────┘ └────────┘ └────────┘ └────────┘
┌─────────────────────────────────────────────────────┐
│  Agent Layer (330+ installed TOML files)              │
│  OMO 9 · OMX 33 · Awesome Core 54 · Superpowers 1   │
│  + 20 domain agent-packs (on-demand)                  │
├─────────────────────────────────────────────────────┤
│  Skills Layer (200+ from ECC + gstack + OMX + more)  │
│  tdd-workflow · security-review · autopilot           │
│  pdf · docx · pptx · xlsx · team                     │
├─────────────────────────────────────────────────────┤
│  MCP Layer                                            │
│  Context7 · Exa · grep.app                            │
└─────────────────────────────────────────────────────┘

---

What's Inside

| Category | Count | Source | |----------|------:|--------| | Core agents (always loaded) | 98 | Boss 1 + OMO 9 + OMX 33 + Awesome Core 54 + Superpowers 1 | | Agent packs (on-demand) | 220+ | 20 domain categories from agency-agents + awesome-codex-subagents | | Skills | 200+ | ECC 180+ · gstack 40 · OMX 36 · Superpowers 14 · Core 2 | | MCP Servers | 3 | Context7, Exa, grep.app | | config.toml | 1 | my-codex | | AGENTS.md | 1 | my-codex |

Core Agent — Boss meta-orchestrator (1)

| Agent | Model | Role | Source | |-------|-------|------|--------| | Boss | o3 high | Dynamic runtime discovery → capability matching → optimal routing. Never writes code. | my-codex |

OMO Agents — Sub-orchestrators and specialists (9)

| Agent | Model | Role | Source | |-------|-------|------|--------| | Sisyphus | o3 high | Intent classification → specialist delegation → verification | oh-my-openagent | | Hephaestus | o3 high | Autonomous explore → plan → execute → verify | oh-my-openagent | | Atlas | o3 high | Task decomposition + 4-stage QA verification | oh-my-openagent | | Oracle | o3 high | Strategic technical consulting (read-only) | oh-my-openagent | | Metis | o3 high | Intent analysis, ambiguity detection | oh-my-openagent | | Momus | o3 high | Plan feasibility review | oh-my-openagent | | Prometheus | o3 high | Interview-based detailed planning | oh-my-openagent | | Librarian | o3 medium | Open-source documentation search via MCP | oh-my-openagent | | Multimodal-Looker | o3 medium | Image/screenshot/diagram analysis | oh-my-openagent |

OMC Agents — Specialist workers (19)

| Agent | Role | Source | |-------|------|--------| | analyst | Pre-analysis before planning | oh-my-claudecode | | architect | System design and architecture | oh-my-claudecode | | code-reviewer | Focused code review | oh-my-claudecode | | code-simplifier | Code simplification and cleanup | oh-my-claudecode | | critic | Critical analysis, alternative proposals | oh-my-claudecode | | debugger | Focused debugging | oh-my-claudecode | | designer | UI/UX design guidance | oh-my-claudecode | | document-specialist | Documentation writing | oh-my-claudecode | | executor | Task execution | oh-my-claudecode | | explore | Codebase exploration | oh-my-claudecode | | git-master | Git workflow management | oh-my-claudecode | | planner | Rapid planning | oh-my-claudecode | | qa-tester | Quality assurance testing | oh-my-claudecode | | scientist | Research and experimentation | oh-my-claudecode | | security-reviewer | Security review | oh-my-claudecode | | test-engineer | Test writing and maintenance | oh-my-claudecode | | tracer | Execution tracing and analysis | oh-my-claudecode | | verifier | Final verification | oh-my-claudecode | | writer | Content and documentation | oh-my-claudecode |

Awesome Core Agents (54) — From awesome-codex-subagents

4 categories installed to ~/.codex/agents/:

01-core-development (12) accessibility-tester, ad-security-reviewer, agent-installer, api-designer, code-documenter, code-reviewer, dependency-manager, full-stack-developer, monorepo-specialist, performance-optimizer, refactoring-specialist, tech-debt-analyzer

03-infrastructure (16) azure-infra-engineer, cloud-architect, container-orchestrator, database-architect, disaster-recovery-planner, edge-computing-specialist, infrastructure-as-code, kubernetes-operator, load-balancer-specialist, message-queue-designer, microservices-architect, monitoring-specialist, network-engineer, serverless-architect, service-mesh-designer, storage-architect

04-quality-security (16) api-security-tester, chaos-engineer, compliance-auditor, contract-tester, data-privacy-officer, e2e-test-architect, incident-responder, load-tester, mutation-tester, penetration-tester, regression-tester, security-scanner, soc-analyst, static-analyzer, threat-modeler, vulnerability-assessor

09-meta-orchestration (10) agent-organizer, capability-assessor, conflict-resolver, context-manager, execution-planner, multi-agent-coordinator, priority-manager, resource-allocator, task-decomposer, workflow-orchestrator

Superpowers Agent (1) — From obra/superpowers

| Agent | Role | Source | |-------|------|--------| | superpowers-code-reviewer | Comprehensive code review with brainstorming and TDD verification | superpowers |

Agent Packs — On-demand domain specialists (21 categories)

Installed to ~/.codex/agent-packs/. Managed via:

# View current state
~/.codex/bin/my-codex-packs status

# Enable a pack immediately
~/.codex/bin/my-codex-packs enable marketing

# Switch profiles at install time
bash /tmp/my-codex/install.sh --profile minimal
bash /tmp/my-codex/install.sh --profile full

| Pack | Count | Examples | |------|------:|---------| | engineering | 32 | Backend, Frontend, Mobile, DevOps, AI, Data | | marketing | 27 | Douyin, Xiaohongshu, WeChat OA, TikTok, SEO | | language-specialists | 27 | Python, Go, Rust, Swift, Kotlin, Java | | specialized | 31 | Legal, Finance, Healthcare, Workflow | | game-development | 20 | Unity, Unreal, Godot, Roblox, Blender | | infrastructure | 19 | Cloud, K8s, Terraform, Docker, SRE | | developer-experience | 13 | MCP Builder, LSP, Terminal, Rapid Prototyper | | data-ai | 13 | Data Engineer, ML, Database, ClickHouse | | specialized-domains | 12 | Supply Chain, Logistics, E-Commerce | | design | 11 | Brand, UI, UX, Visual Storytelling | | business-product | 11 | Product Manager, Growth, Analytics | | testing | 11 | API, Accessibility, Performance, E2E, QA | | sales | 8 | Deal strategy, pipeline, outbound | | paid-media | 7 | Google Ads, Meta Ads, Programmatic | | research-analysis | 7 | Trend, Market, Competitive Analysis | | project-management | 6 | Agile, Jira, workflows | | spatial-computing | 6 | XR, WebXR, AR/VR, visionOS | | support | 6 | Customer support, developer advocacy | | academic | 5 | Study abroad, corporate training | | product | 5 | Product management, UX research | | security | 5 | Penetration testing, compliance, audit |

Skills — 200+ from 5 sources

| Source | Count | Key Skills | |--------|------:|------------| | everything-claude-code | 180+ | tdd-workflow, autopilot, security-review, coding-standards | | oh-my-codex | 36 | plan, team, trace, deep-dive, blueprint, ultrawork | | gstack | 40 | /qa, /review, /ship, /cso, /investigate, /office-hours | | superpowers | 14 | brainstorming, systematic-debugging, TDD, parallel-agents | | my-codex Core | 2 | boss-advanced, boss-briefing |

MCP Servers (3)

| Server | Purpose | Cost | |--------|---------|------| | Context7 | Real-time library documentation | Free | | Exa | Semantic web search | Free 1k req/month | | grep.app | GitHub code search | Free |

---

Briefing Vault

Obsidian-compatible persistent memory. Every project maintains a .briefing/ directory that updates during Codex sessions via native plugin hooks, with wrapper fallback for session start/end continuity.

.briefing/
├── INDEX.md                          ← Project context (auto-created once)
├── state.json                        ← Session metadata, counters, lastVaultSync (auto-managed)
├── sessions/
│   ├── YYYY-MM-DD-.md        ← Human/agent-written follow-up session summary
│   └── YYYY-MM-DD-auto.md           ← Auto-generated scaffold (recorded files, filtered status, follow-up)
├── decisions/
│   └── YYYY-MM-DD-.md     ← Human/agent-written decision record
├── learnings/
│   ├── YYYY-MM-DD-.md      ← Human/agent-written learning note
│   └── YYYY-MM-DD-auto-session.md   ← Auto-generated scaffold (files, wrapper activity, prompts)
├── references/
│   └── auto-links.md                ← Reserved for collected research links
├── archives/                         ← PARA: completed/inactive notes (flat)
├── wiki/                             ← LLM-wiki: concept pages
│   └── _schema.md
├── agents/
│   ├── agent-log.jsonl              ← Wrapper/session log
│   └── YYYY-MM-DD-summary.md        ← Daily logged-signal breakdown
└── persona/
    ├── profile.md                   ← Routing/profile summary from logged signals
    ├── suggestions.jsonl            ← Routing suggestions (auto-generated)
    ├── persona-policy.json          ← Accepted soft routing preferences for Boss
    └── rules/                       ← Workflow pattern rules (workflow-*.md)

Sub-Vaults

| Path | Description | |------|-------------| | INDEX.md | Project overview with links to recent decisions and learnings. Auto-created on first session, refreshed periodically. | | sessions/ | Session summaries. *-auto.md — auto-generated scaffold refreshed during the session and finalized at stop using recorded session files, filtered status, and logged signals. .md — human or agent-written follow-up session summary prompted by the vault reminders. | | decisions/ | Architecture and design decisions with rationale. Write these as durable notes when a decision is important enough to keep. | | learnings/ | Patterns, gotchas, non-obvious solutions. *-auto-session.md — auto-generated scaffold refreshed during the session with the session's recorded file list, logged signals, and prompts for follow-up notes. .md — human or agent-written learning note. | | references/ | Web research URLs. references/auto-links.md is updated from WebSearch/WebFetch hook activity when those native Codex hooks are available. | | agents/ | Logged session signals. agent-log.jsonl — enriched entries with {ts, agent_id, agent_type, phase, seq, task_hint}. YYYY-MM-DD-summary.md — d

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: sehoon787
• Source: sehoon787/my-codex
• License: MIT
• Homepage: https://sehoon787.github.io/my-codex/

Install and usage instructions live in the source repository linked above.