Skip to content
/

oh-my-customcodex (baekenough)

baekenough-oh-my-customcodex · baekenough/oh-my-customcodex · ★ 3 · last commit 2026-05-24

Codex-native port of oh-my-customcode: 49 agents, 123 skills, compiled from source using the skills-as-source-agents-as-artifacts metaphor, with dynamic agent creation for missing domains.

Best whenAgent systems should be treated as compiled artifacts from skill source code, not static configurations — mgr-sauron verifies integrity and mgr-creator compi…
Skip ifConfiguring agents manually (skills should drive agent compilation), Failing when no specialist exists (create one instead)
vs seeds
bmad-method(large specialist agent roster) and claude-flow (npm package + CLI + TypeScript), but uniquely frames agent systems as a…
Primitive shape 172 total
Skills 123 Subagents 49
00

Summary

oh-my-customcodex (baekenough) — Summary

oh-my-customcodex is a Codex-native (GPT-based) port of oh-my-customcode, maintaining the same agent compilation metaphor but running on top of GPT Codex + OMX stack instead of Claude Code. It ships 49 agents, 123 skills, and 22 rules accessible via a single install command (omcustomcodex init). The distinctive philosophy: "agent systems are compiled, not configured" — skills are source code, agents are compiled output, and mgr-sauron acts as the compiler/verifier. The reasoning-sandwich pattern (Opus for pre-analysis, Sonnet for implementation, Haiku for post-verification) and mgr-creator (dynamic agent creation when no specialist exists) are the two most novel components. The npm package ships a dedicated CLI binary omcustomcodex and maintains multi-model routing (opus/sonnet/haiku per role).

Differs from seeds: Closest to BMAD-METHOD (large specialist agent roster with routing) and claude-flow (CLI binary + npm package), but uniquely frames agent systems as a compilation problem (skills=source, agents=compiled artifacts, sauron=compiler), implements dynamic agent creation (mgr-creator) for missing domain expertise, and runs on Codex/OMX rather than Claude Code — a provider boundary that distinguishes it from all 11 seeds.

01

Overview

oh-my-customcodex (baekenough) — Overview

Origin

A child package / port of oh-my-customcode, converting the Claude Code native harness to run on GPT Codex + OMX. The AGENTS.md explicitly states:

"oh-my-customcodex is a child package of oh-my-customcode. The core porting purpose of this repository is: take the Claude Code native harness from oh-my-customcode and make it run on top of a GPT Codex + OMX stack."

Version 0.5.4, MIT license, 3 stars.

Philosophy — "Compiled, Not Configured"

The most distinctive framing in this batch:

"Agent systems are compiled, not configured."

Compile Concept oh-my-customcodex
Source .codex/skills/ — skill definitions
Installed runtime .agents/skills/ — deployed knowledge
Build artifacts .codex/agents/ — compiled specialists
Compiler mgr-sauron (R017)
Spec .codex/rules/ — build rules
Linker Routing skills
Standard library guides/

Dynamic Agent Creation

"If it can't be done, make it work. When no specialist exists for a task, oh-my-customcodex does not fail. It creates one."

User: "Review this Terraform module"
  → Routing: no terraform expert found
  → mgr-creator discovers: infra-aws-expert skills + docker-best-practices guide
  → Creates: infra-terraform-expert.md
  → Executes the review immediately
  → Agent persists for future use

Reasoning-Sandwich Pattern

Opus (pre-analysis) → Sonnet (implementation) → Haiku (post-verification)

Response Contract

Every response starts with an agent identification block:

┌─ Agent: Codex (gpt-5.4)
├─ Skill: <active-skill-or-routing-surface>
└─ Status: <current-action-or-verdict>
02

Architecture

oh-my-customcodex (baekenough) — Architecture

Distribution

  • Type: npm package + CLI binary (omcustomcodex)
  • Version: 0.5.4
  • Default branch: develop

Install

npm install -g oh-my-customcodex && cd your-project && omcustomcodex init

Directory Tree

oh-my-customcodex/
├── .claude-plugin/       # Claude Code plugin compatibility
├── .codex/               # Codex-specific config
├── .clawhip/             # OMX integration
├── .omx/                 # OMX config files
├── .mcp.json             # MCP server config
├── agents/               # 49 compiled agent definitions
├── skills/               # 123 skill definitions (+ routing)
├── src/
│   └── cli/
│       └── index.ts      # CLI entry point
├── templates/            # Project templates
├── package.json
│   └── bin.omcustomcodex: "./dist/cli/index.js"
├── missions/             # Mission definitions
├── seminar/              # Seminar-style learning
├── shellmark/            # Shell bookmarks
├── dist/                 # Build output
└── README.*.md           # 12-language READMEs

Multilingual Documentation

README available in 12 languages (German, Spanish, French, Italian, Japanese, Korean, Portuguese, Russian, Turkish, Vietnamese, Chinese + English) — most localized framework in this batch.

Required Runtime

  • Node.js (npm package)
  • Bun (build tooling)
  • GPT Codex + OMX (runtime agents)

Target Tools

  • Codex (primary)
  • Claude Code (via .claude-plugin compatibility)
  • OMX orchestrator
03

Components

oh-my-customcodex (baekenough) — Components

Agents (49)

Category Count Names
Languages 6 lang-golang, lang-python, lang-rust, lang-kotlin, lang-typescript, lang-java21
Backend 6 be-fastapi, be-springboot, be-go-backend, be-express, be-nestjs, be-django
Frontend 5 fe-vercel, fe-vuejs, fe-svelte, fe-flutter, fe-design
Data Engineering 6 de-airflow, de-dbt, de-spark, de-kafka, de-snowflake, de-pipeline
Database 4 db-supabase, db-postgres, db-redis, db-alembic
Tooling 3 tool-npm, tool-optimizer, tool-bun
Architecture 2 arch-documenter, arch-speckit
Infrastructure 2 infra-docker, infra-aws
QA 3 qa-planner, qa-writer, qa-engineer
Security 1 sec-codeql
Managers 6 mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible
System 3 sys-memory-keeper, sys-naggy, tracker-checkpoint
Auxiliary 2 slack-cli, wiki-curator

Each agent uses YAML frontmatter declaring tools, model, memory scope, and limitations.

Skills (123)

Category Count
Best Practices 24
Routing 4 (secretary, dev-lead, de-lead, qa-lead)
Workflow 13
Development 10
Operations 10
Memory 3
Package 3
Optimization 3
Security 3
Other 13

Routing Skills (4)

Skill Routes To
secretary-routing Manager agents (mgr-), system agents (sys-)
dev-lead-routing Language, backend, frontend, tooling, DB, infra, arch agents
de-lead-routing Data engineering agents (de-*)
qa-lead-routing QA team

Key Manager Agents

  • mgr-creator: Creates new specialized agents when no expert exists for a task
  • mgr-sauron: Structural verification and integrity compiler
  • mgr-gitnerd: Git workflow management
  • mgr-updater: Updates existing agents with new skills
  • mgr-supplier: Supplies context and materials to agents

Model Assignment

Model Role
opus Complex reasoning, architecture, design review
sonnet Implementation, code generation (most agents)
haiku Fast validation, search, verification
05

Prompts

oh-my-customcodex (baekenough) — Prompt Excerpts

Excerpt 1: AGENTS.md (Response Contract)

Technique: Global response format contract injected via AGENTS.md

# Repository Guidance

- oh-my-customcodex is a child package of oh-my-customcode.
- Use omcustomcodex in shell examples and operator guidance.
- Repo-local response contract:
  - Start responses with an agent identification block.
  - If no skill is active, still show Agent and Status.
  - Prefer this visible format:

    ┌─ Agent: Codex (gpt-5.4)
    ├─ Skill: <active-skill-or-routing-surface>
    └─ Status: <current-action-or-verdict>

- Preserve upstream behavior, structure, naming patterns, release flow, CI intent,
  and package shape unless the change is required to convert the provider boundary.
- The core porting purpose of this repository is: take the Claude Code native harness
  from oh-my-customcode and make it run on top of a GPT Codex + OMX stack.
- Treat this repository as the child-package port that preserves parent-package behavior
  while moving the harness onto GPT Codex + OMX, not as an independent redesign.

Analysis: AGENTS.md enforces a visible structured response format on every interaction — the identification block (┌─ Agent: ... ├─ Skill: ... └─ Status: ...) makes agent identity and active skill always visible to the user. This is an observability-in-output pattern not present in other frameworks.


Excerpt 2: README.md — Compilation Metaphor

Technique: Compile-chain conceptual framing injected into agent behavior via README/CLAUDE.md

**1. Agent systems are compiled, not configured.**

Skills are source. Agents are compiled output. Sauron verifies the build.
This separation means skills evolve independently of agents, and agents can be
recompiled from updated skills at any time.

**2. If it can't be done, make it work.**

When no specialist exists for a task, oh-my-customcodex does not fail. It creates one:
User: "Review this Terraform module"
  → Routing: no terraform expert found
  → mgr-creator discovers: infra-aws-expert skills + docker-best-practices guide
  → Creates: infra-terraform-expert.md
  → Executes the review immediately
  → Agent persists for future use

Analysis: The compilation metaphor frames how agents and skills relate — not just a cognitive aid but an operational principle enforced by mgr-sauron (integrity check) and mgr-creator (dynamic compilation). The "never fail, create instead" design is a runtime behavior contract embedded in the philosophy.

09

Uniqueness

oh-my-customcodex (baekenough) — Uniqueness

Differs from Seeds

Closest to BMAD-METHOD (49 specialist agents + routing) and claude-flow (npm package + CLI binary + TypeScript), but differs on three axes: (1) "compiled not configured" framing — skills as source code, agents as compiled artifacts, sauron as compiler/verifier, mgr-creator for dynamic agent compilation on demand — no seed has this architecture metaphor; (2) runs on GPT Codex + OMX rather than Claude Code, making it the Codex-native counterpart to the Claude Code-native frameworks; (3) the reasoning-sandwich pattern (opus pre-analysis → sonnet implementation → haiku post-verification) as an explicit named workflow primitive, different from BMAD's persona chain or claude-flow's MCP routing.

The visible response format (┌─ Agent: ... ├─ Skill: ... └─ Status: ...) is also unique: no other seed or batch framework mandates an agent identification header on every response.

Positioning

  • A Codex port of oh-my-customcode (parent package), targeting the "same UX on a different provider" use case
  • 49 agents covers the broadest domain roster in this batch (languages, backends, frontends, data, DB, infra, QA, security, managers, system agents)
  • At 0.5.4, it is early-stage but architecturally ambitious

Observable Failure Modes

  1. Dynamic agent quality: mgr-creator creates agents from combining existing skills + guides — the quality of created agents depends on the available skills and the composition logic; poorly assembled agents may execute with incorrect constraints
  2. mgr-sauron integrity: If the sauron verifier has incomplete rules or false positives, it may block valid agent configurations
  3. Codex-first, Claude-second: Claude Code compatibility is a .claude-plugin/ wrapper around a Codex-native design — feature parity with native Claude Code frameworks is not guaranteed
  4. Rule proliferation: 22 rules in .codex/rules/ + 123 skills creates a large knowledge surface; agents may receive contradictory or overlapping instructions
  5. Parallel agent conflicts: Up to 4 agents running in parallel on the same codebase may create edit conflicts (no worktree isolation mentioned)
04

Workflow

oh-my-customcodex (baekenough) — Workflow

Core Orchestration Pattern

User (natural language)
  → Main conversation (singleton orchestrator — R010)
    → Never writes files directly
    → Routing skill (intent detection, confidence scoring)
      → Specialized agent (isolated execution)
        → Result returned to orchestrator
          → Response to user

Parallel Execution (R009)

Up to 4 concurrent agents per message:

Agent(lang-golang-expert):sonnet  ┐
Agent(lang-python-expert):sonnet  ├─ All spawned in ONE message
Agent(qa-engineer):sonnet         │
Agent(arch-documenter):haiku      ┘

Reasoning-Sandwich Pattern

Agent(planner):opus  → pre-analysis, requirements extraction
Agent(implementer):sonnet  → code generation
Agent(verifier):haiku  → post-verification, lint, count check

Dynamic Agent Creation (mgr-creator)

When no specialist exists:

  1. mgr-creator discovers relevant skills + guides
  2. Creates a new agent markdown file
  3. Executes the task with the new agent
  4. New agent persists for future use

Phase-to-Artifact Map

Phase Agent Artifact
Routing secretary/dev-lead/de-lead/qa-lead routing skills Agent selection
Planning planner (opus) Task breakdown
Implementation language/backend/frontend specialist (sonnet) Code changes
Review code-reviewer (sonnet) Review report
QA qa-engineer (sonnet) Test results
Verification haiku agents Verification report
Git mgr-gitnerd Commits/PRs

Rules (22)

The .codex/rules/ directory contains 22 build rules including:

  • R009: Parallel execution for independent tasks
  • R010: Main conversation as singleton orchestrator
  • R017: mgr-sauron structural verification

Approval Gates

  • Ambiguous routing: confidence scoring with fallback
  • Pre-generation architecture check (pre-generation-arch-check skill)
06

Memory Context

oh-my-customcodex (baekenough) — Memory & Context

State Storage

  • Type: File-based
  • .agents/skills/ — installed runtime skills (deployed knowledge)
  • .codex/agents/ — compiled agent definitions
  • sys-memory-keeper agent — dedicated memory management agent

Memory Skills (3)

  • memory-save — persists knowledge to files
  • memory-recall — retrieves from knowledge files
  • memory-management — manages the memory lifecycle

Wiki System

  • wiki-curator agent: maintains a project wiki
  • wiki-session-start script: loads wiki context at session start

Project Memory

Yeachan-Heo's OMC (parent framework) has a project-session-manager (PSM) feature. baekenough's fork preserves the OMX-adapted equivalent.

Agent Identity Block

The response format (┌─ Agent: ... ├─ Skill: ... └─ Status: ...) provides session-level context about which agent is active and which skill is running — implicit context visibility.

Cross-Session Handoff

  • Memory skills enable explicit save/recall across sessions
  • Compiled agent files (.codex/agents/) persist new agents created by mgr-creator
  • .codex/rules/ persist build rules

Context Efficiency

  • Tool budgets enforced per agent type (accuracy vs cost tradeoff)
  • haiku for verification (fast, cheap)
  • Parallel execution (up to 4 agents) reduces per-agent context load
07

Orchestration

oh-my-customcodex (baekenough) — Orchestration

Multi-Agent Pattern

Pattern: Hierarchical with dynamic routing + parallel fan-out

User
  → Main conversation (singleton orchestrator, R010)
    → Routing skill (intent detection, confidence scoring)
      ↓
      One of four routing surfaces:
        secretary-routing → mgr-* + sys-* agents
        dev-lead-routing → language + backend + frontend + infra agents
        de-lead-routing → de-* agents
        qa-lead-routing → qa-* agents
      ↓
      Specialized agent execution (up to 4 parallel, R009)

Dynamic Agent Creation (mgr-creator)

When no expert is found:

mgr-creator → finds skills + guides → creates new agent .md → executes → persists

This is a "compile-on-demand" pattern — the agent system grows as it encounters new domains.

Reasoning-Sandwich (Multi-tier Model Use)

Opus (planner/critic) → "What should we do and why?"
Sonnet (executor) → "Implement it"
Haiku (verifier) → "Is it correct? Count X, check Y"

Provides cost efficiency while maintaining quality at high-stakes decision points.

Isolation Mechanism

  • Process isolation: Each agent runs in isolated execution context (Codex runtime)
  • Not git-worktree based (Codex manages this at the CLI level)

Target Runtime

  • Codex (GPT-based, primary)
  • OMX orchestrator for routing
  • Claude Code compatibility via .claude-plugin/

Multi-Model

Yes: Explicit model assignment per agent:

  • opus: complex reasoning, design review, research synthesis
  • sonnet: implementation, general tasks, code generation
  • haiku: fast validation, search, count verification

Concurrency

Up to 4 agents per message (R009 rule).

08

Ui Cli Surface

oh-my-customcodex (baekenough) — UI/CLI Surface

CLI Binary

  • Exists: Yes
  • Name: omcustomcodex
  • Install: npm install -g oh-my-customcodex
  • Entry point: ./dist/cli/index.js

Primary CLI Command

omcustomcodex init    # Initialize project with oh-my-customcodex

Additional subcommands available from src/cli/index.ts (exact subcommands not inspected).

Response Format (In-session UI)

Every agent response starts with:

┌─ Agent: Codex (gpt-5.4)
├─ Skill: <active-skill-or-routing-surface>
└─ Status: <current-action-or-verdict>

This provides a visible "who is acting and on what" status in the terminal conversation.

Local UI

  • Exists: No web dashboard
  • Terminal-only interaction

Multilingual Documentation

README in 12 languages (German, Spanish, French, Italian, Japanese, Korean, Portuguese, Russian, Turkish, Vietnamese, Chinese, English) — most internationally localized framework in this batch.

npm Package

  • Package name: oh-my-customcodex
  • GitHub Packages: @baekenough/oh-my-customcodex
  • Published to npm registry (https://registry.npmjs.org/)

Compatibility

  • .claude-plugin/ directory for Claude Code marketplace compatibility
  • Primary runtime: Codex + OMX

Related frameworks

same archetype · same primary tool · same memory type

Claude-Flow / Ruflo ★ 55k

Eliminates single-agent context limits and sequential bottlenecks by orchestrating fault-tolerant swarms of specialized AI agents…

Hermes Agent (NousResearch) ★ 168k

Self-improving personal AI agent with closed learning loop, 7 terminal backends, and messaging gateway — not tied to any AI…

OpenCode ★ 165k

Terminal-first AI coding agent with multi-model routing, native desktop app, and a typed .opencode/ configuration system for…

OpenHands ★ 75k

Open-source AI software development platform (open-source Devin alternative) with Docker sandbox isolation, 77.6% SWE-bench…

DeerFlow ★ 70k

Long-horizon superagent that researches, codes, and creates by orchestrating parallel sub-agents with isolated contexts in Docker…

oh-my-openagent (omo) ★ 60k

Multi-provider AI agent orchestration for OpenCode: escape vendor lock-in by routing Sisyphus (Claude/Kimi/GLM) and Hephaestus…