oh-my-customcodex 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +75 -21
- package/README.md +6 -2
- package/dist/cli/index.js +5 -5
- package/dist/index.js +5 -5
- package/package.json +4 -4
- package/templates/.claude/hooks/scripts/agent-teams-advisor.sh +3 -3
- package/templates/.claude/hooks/scripts/git-delegation-guard.sh +1 -1
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +1 -1
- package/templates/.claude/skills/dag-orchestration/SKILL.md +2 -2
- package/templates/.claude/skills/secretary-routing/SKILL.md +2 -2
- package/templates/.claude/skills/status/SKILL.md +8 -13
- package/templates/AGENTS.md.en +3 -3
- package/templates/AGENTS.md.ko +3 -3
- package/templates/CLAUDE.md +3 -3
- package/templates/CLAUDE.md.en +2 -2
- package/templates/CLAUDE.md.ko +2 -2
- package/templates/guides/cc-token-saver/README.md +4 -4
- package/templates/guides/claude-code/03-tools.md +1 -1
- package/templates/guides/claude-code/06-mcp.md +1 -1
- package/templates/guides/claude-code/15-version-compatibility.md +16 -0
- package/templates/guides/openai-codex/01-version-compatibility.md +30 -0
- package/templates/manifest.json +2 -2
package/LICENSE
CHANGED
|
@@ -1,21 +1,75 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
1
|
+
# PolyForm Noncommercial License 1.0.0
|
|
2
|
+
|
|
3
|
+
<https://polyformproject.org/licenses/noncommercial/1.0.0>
|
|
4
|
+
|
|
5
|
+
Required Notice: Copyright (c) 2026 baekenough (https://github.com/baekenough)
|
|
6
|
+
|
|
7
|
+
## Acceptance
|
|
8
|
+
|
|
9
|
+
In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
|
|
10
|
+
|
|
11
|
+
## Copyright License
|
|
12
|
+
|
|
13
|
+
The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to Distribution License and make changes or new works based on the software according to Changes and New Works License.
|
|
14
|
+
|
|
15
|
+
## Distribution License
|
|
16
|
+
|
|
17
|
+
The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by Changes and New Works License.
|
|
18
|
+
|
|
19
|
+
## Notices
|
|
20
|
+
|
|
21
|
+
You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
|
|
22
|
+
|
|
23
|
+
> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
|
|
24
|
+
|
|
25
|
+
## Changes and New Works License
|
|
26
|
+
|
|
27
|
+
The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
|
|
28
|
+
|
|
29
|
+
## Patent License
|
|
30
|
+
|
|
31
|
+
The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
|
|
32
|
+
|
|
33
|
+
## Noncommercial Purposes
|
|
34
|
+
|
|
35
|
+
Any noncommercial purpose is a permitted purpose.
|
|
36
|
+
|
|
37
|
+
## Personal Uses
|
|
38
|
+
|
|
39
|
+
Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
|
|
40
|
+
|
|
41
|
+
## Noncommercial Organizations
|
|
42
|
+
|
|
43
|
+
Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
|
|
44
|
+
|
|
45
|
+
## Fair Use
|
|
46
|
+
|
|
47
|
+
You may have "fair use" rights for the software under the law. These terms do not limit them.
|
|
48
|
+
|
|
49
|
+
## No Other Rights
|
|
50
|
+
|
|
51
|
+
These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
|
|
52
|
+
|
|
53
|
+
## Patent Defense
|
|
54
|
+
|
|
55
|
+
If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
|
|
56
|
+
|
|
57
|
+
## Violations
|
|
58
|
+
|
|
59
|
+
The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
|
|
60
|
+
|
|
61
|
+
## No Liability
|
|
62
|
+
|
|
63
|
+
As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.
|
|
64
|
+
|
|
65
|
+
## Definitions
|
|
66
|
+
|
|
67
|
+
The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
|
|
68
|
+
|
|
69
|
+
**You** refers to the individual or entity agreeing to these terms.
|
|
70
|
+
|
|
71
|
+
**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
|
|
72
|
+
|
|
73
|
+
**Your licenses** are all the licenses granted to you for the software under these terms.
|
|
74
|
+
|
|
75
|
+
**Use** means anything you do with the software requiring one of your licenses.
|
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
> **Your AI Agent Stack. Compiled, Not Configured.**
|
|
8
8
|
|
|
9
9
|
[](https://www.npmjs.com/package/oh-my-customcodex)
|
|
10
|
-
[](https://polyformproject.org/licenses/noncommercial/1.0.0/)
|
|
11
11
|
[](https://github.com/baekenough/oh-my-customcodex/actions/workflows/ci.yml)
|
|
12
12
|
[](https://github.com/baekenough/oh-my-customcodex/actions/workflows/security-audit.yml)
|
|
13
13
|
|
|
@@ -333,7 +333,11 @@ Requirements: Node.js >= 18.0.0, Bun, Codex CLI. GitHub CLI (`gh`) and `jq` are
|
|
|
333
333
|
|
|
334
334
|
## License
|
|
335
335
|
|
|
336
|
-
[
|
|
336
|
+
This project is licensed under the **[PolyForm Noncommercial License 1.0.0](LICENSE)**.
|
|
337
|
+
|
|
338
|
+
You are free to **use, modify, and distribute** oh-my-customcodex for any **noncommercial** purpose — personal projects, research, education, and nonprofit/government use. **Commercial use is not permitted** under this license.
|
|
339
|
+
|
|
340
|
+
Need a commercial license? Open an issue or reach out to the author.
|
|
337
341
|
|
|
338
342
|
---
|
|
339
343
|
|
package/dist/cli/index.js
CHANGED
|
@@ -3091,7 +3091,7 @@ var init_package = __esm(() => {
|
|
|
3091
3091
|
workspaces: [
|
|
3092
3092
|
"packages/*"
|
|
3093
3093
|
],
|
|
3094
|
-
version: "1.0.
|
|
3094
|
+
version: "1.0.5",
|
|
3095
3095
|
requiresCC: ">=2.1.121",
|
|
3096
3096
|
claudeCode: {
|
|
3097
3097
|
minimumVersion: "2.1.121",
|
|
@@ -3148,8 +3148,8 @@ var init_package = __esm(() => {
|
|
|
3148
3148
|
"@types/bun": "^1.3.6",
|
|
3149
3149
|
"@types/js-yaml": "^4.0.9",
|
|
3150
3150
|
"@types/nodemailer": "^8.0.0",
|
|
3151
|
-
"js-yaml": "^
|
|
3152
|
-
nodemailer: "^
|
|
3151
|
+
"js-yaml": "^5.2.0",
|
|
3152
|
+
nodemailer: "^9.0.1",
|
|
3153
3153
|
typescript: "^6.0.2",
|
|
3154
3154
|
vitepress: "^1.6.4"
|
|
3155
3155
|
},
|
|
@@ -3162,7 +3162,7 @@ var init_package = __esm(() => {
|
|
|
3162
3162
|
"cli"
|
|
3163
3163
|
],
|
|
3164
3164
|
author: "baekenough",
|
|
3165
|
-
license: "
|
|
3165
|
+
license: "PolyForm-Noncommercial-1.0.0",
|
|
3166
3166
|
repository: {
|
|
3167
3167
|
type: "git",
|
|
3168
3168
|
url: "git+https://github.com/baekenough/oh-my-customcodex.git"
|
|
@@ -26982,7 +26982,7 @@ init_lockfile();
|
|
|
26982
26982
|
init_logger();
|
|
26983
26983
|
import { execSync as execSync4 } from "node:child_process";
|
|
26984
26984
|
import { platform as platform2 } from "node:os";
|
|
26985
|
-
var MINIMUM_OMX_VERSION = "0.18.
|
|
26985
|
+
var MINIMUM_OMX_VERSION = "0.18.17";
|
|
26986
26986
|
var defaultDeps2 = {
|
|
26987
26987
|
exec: execSync4,
|
|
26988
26988
|
getPlatform: platform2
|
package/dist/index.js
CHANGED
|
@@ -1569,7 +1569,7 @@ init_lockfile();
|
|
|
1569
1569
|
init_logger();
|
|
1570
1570
|
import { execSync as execSync2 } from "node:child_process";
|
|
1571
1571
|
import { platform as platform2 } from "node:os";
|
|
1572
|
-
var MINIMUM_OMX_VERSION = "0.18.
|
|
1572
|
+
var MINIMUM_OMX_VERSION = "0.18.17";
|
|
1573
1573
|
var defaultDeps2 = {
|
|
1574
1574
|
exec: execSync2,
|
|
1575
1575
|
getPlatform: platform2
|
|
@@ -2316,7 +2316,7 @@ var package_default = {
|
|
|
2316
2316
|
workspaces: [
|
|
2317
2317
|
"packages/*"
|
|
2318
2318
|
],
|
|
2319
|
-
version: "1.0.
|
|
2319
|
+
version: "1.0.5",
|
|
2320
2320
|
requiresCC: ">=2.1.121",
|
|
2321
2321
|
claudeCode: {
|
|
2322
2322
|
minimumVersion: "2.1.121",
|
|
@@ -2373,8 +2373,8 @@ var package_default = {
|
|
|
2373
2373
|
"@types/bun": "^1.3.6",
|
|
2374
2374
|
"@types/js-yaml": "^4.0.9",
|
|
2375
2375
|
"@types/nodemailer": "^8.0.0",
|
|
2376
|
-
"js-yaml": "^
|
|
2377
|
-
nodemailer: "^
|
|
2376
|
+
"js-yaml": "^5.2.0",
|
|
2377
|
+
nodemailer: "^9.0.1",
|
|
2378
2378
|
typescript: "^6.0.2",
|
|
2379
2379
|
vitepress: "^1.6.4"
|
|
2380
2380
|
},
|
|
@@ -2387,7 +2387,7 @@ var package_default = {
|
|
|
2387
2387
|
"cli"
|
|
2388
2388
|
],
|
|
2389
2389
|
author: "baekenough",
|
|
2390
|
-
license: "
|
|
2390
|
+
license: "PolyForm-Noncommercial-1.0.0",
|
|
2391
2391
|
repository: {
|
|
2392
2392
|
type: "git",
|
|
2393
2393
|
url: "git+https://github.com/baekenough/oh-my-customcodex.git"
|
package/package.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"workspaces": [
|
|
4
4
|
"packages/*"
|
|
5
5
|
],
|
|
6
|
-
"version": "1.0.
|
|
6
|
+
"version": "1.0.5",
|
|
7
7
|
"requiresCC": ">=2.1.121",
|
|
8
8
|
"claudeCode": {
|
|
9
9
|
"minimumVersion": "2.1.121",
|
|
@@ -60,8 +60,8 @@
|
|
|
60
60
|
"@types/bun": "^1.3.6",
|
|
61
61
|
"@types/js-yaml": "^4.0.9",
|
|
62
62
|
"@types/nodemailer": "^8.0.0",
|
|
63
|
-
"js-yaml": "^
|
|
64
|
-
"nodemailer": "^
|
|
63
|
+
"js-yaml": "^5.2.0",
|
|
64
|
+
"nodemailer": "^9.0.1",
|
|
65
65
|
"typescript": "^6.0.2",
|
|
66
66
|
"vitepress": "^1.6.4"
|
|
67
67
|
},
|
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
"cli"
|
|
75
75
|
],
|
|
76
76
|
"author": "baekenough",
|
|
77
|
-
"license": "
|
|
77
|
+
"license": "PolyForm-Noncommercial-1.0.0",
|
|
78
78
|
"repository": {
|
|
79
79
|
"type": "git",
|
|
80
80
|
"url": "git+https://github.com/baekenough/oh-my-customcodex.git"
|
|
@@ -6,7 +6,7 @@ command -v jq >/dev/null 2>&1 || exit 0
|
|
|
6
6
|
|
|
7
7
|
# Agent Teams Advisor Hook
|
|
8
8
|
# Trigger: PreToolUse, tool == "Task" || tool == "Agent"
|
|
9
|
-
# Purpose: Track Agent/
|
|
9
|
+
# Purpose: Track Agent/subagent usage count per session and warn when Agent Teams may be more appropriate
|
|
10
10
|
# Protocol: stdin JSON -> process -> stdout pass-through, exit 0 always (advisory only)
|
|
11
11
|
|
|
12
12
|
input=$(cat)
|
|
@@ -63,8 +63,8 @@ if [ "$BATCH_ISSUES" -ge 3 ] && [ "$COUNT" -eq 1 ]; then
|
|
|
63
63
|
echo "-----------------------------------------------------------" >&2
|
|
64
64
|
elif [ "$COUNT" -ge 2 ]; then
|
|
65
65
|
echo "" >&2
|
|
66
|
-
echo "--- [R018 Advisor] Agent/
|
|
67
|
-
echo " WARNING: Multiple
|
|
66
|
+
echo "--- [R018 Advisor] Agent/subagent call #${COUNT} in this session ---" >&2
|
|
67
|
+
echo " WARNING: Multiple Agent/subagent calls detected. Consider Agent Teams if:" >&2
|
|
68
68
|
echo " * 3+ agents needed for this work" >&2
|
|
69
69
|
echo " * Review -> fix -> re-review cycle exists" >&2
|
|
70
70
|
echo " * Agents need shared state or coordination" >&2
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/bin/bash
|
|
2
2
|
# R010 git-delegation-guard hook
|
|
3
|
-
# Warns when git operations are delegated to a non-mgr-gitnerd agent via Agent/
|
|
3
|
+
# Warns when git operations are delegated to a non-mgr-gitnerd agent via Agent/subagent tool.
|
|
4
4
|
# WARN only - does NOT block (exit 0, passes input through).
|
|
5
5
|
#
|
|
6
6
|
# PPID Scoping Convention:
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## Core Rule
|
|
6
6
|
|
|
7
|
-
The main conversation is the **sole orchestrator**. It uses routing skills to delegate tasks to subagents via
|
|
7
|
+
The main conversation is the **sole orchestrator**. It uses routing skills to delegate tasks to subagents via Codex native subagents / the Agent tool. Subagents CANNOT spawn other subagents.
|
|
8
8
|
|
|
9
9
|
**Agent Teams Exception**: Agent Teams members are peers, not hierarchical subagents. Teams members CAN spawn sub-agents via the Agent tool to execute complex workflows (e.g., research teams, verification teams). This enables Teams-compatible skills like `/research` and `/deep-plan` to run inside Team members. The Teams member acts as a local orchestrator for its own sub-tasks.
|
|
10
10
|
|
|
@@ -72,7 +72,7 @@ config:
|
|
|
72
72
|
4. Initialize queue with nodes where in-degree = 0
|
|
73
73
|
5. While queue is not empty:
|
|
74
74
|
a. Dequeue up to max_parallel nodes
|
|
75
|
-
b. Execute nodes in parallel via
|
|
75
|
+
b. Execute nodes in parallel via Codex native subagents (R009)
|
|
76
76
|
c. On completion:
|
|
77
77
|
- Success → decrement in-degree of dependents
|
|
78
78
|
- Failure → apply failure_strategy
|
|
@@ -95,7 +95,7 @@ Sensitive-path compatibility note: if this skill delegates work that touches `.c
|
|
|
95
95
|
| Max parallel | 5 concurrent nodes max, 4 default (R009) |
|
|
96
96
|
| Agent Teams gate | 3+ parallel nodes → check R018 eligibility |
|
|
97
97
|
| Orchestrator only | DAG scheduling runs in main conversation (R010) |
|
|
98
|
-
| Node execution | Each node = one
|
|
98
|
+
| Node execution | Each node = one Codex native subagent task to specified role |
|
|
99
99
|
| State tracking | `/tmp/.codex-dag-$PPID.json` |
|
|
100
100
|
| Stall detection | Running node > 2x avg completed duration → enqueue independent pending nodes early |
|
|
101
101
|
|
|
@@ -28,9 +28,9 @@ Routes agent management tasks to the appropriate manager agent. This skill conta
|
|
|
28
28
|
|
|
29
29
|
## Routing Decision (Priority Order)
|
|
30
30
|
|
|
31
|
-
Before routing via
|
|
31
|
+
Before routing via Codex native subagents, evaluate Agent Teams eligibility first:
|
|
32
32
|
|
|
33
|
-
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over
|
|
33
|
+
**Self-check:** Does this task need 3+ agents, shared state, or inter-agent communication? If yes, prefer Agent Teams over individual subagents. See R018 for the full decision matrix.
|
|
34
34
|
|
|
35
35
|
| Scenario | Preferred |
|
|
36
36
|
|----------|-----------|
|
|
@@ -24,24 +24,19 @@ Show comprehensive system status including agents, skills, guides, and health ch
|
|
|
24
24
|
AI Agent System - Status
|
|
25
25
|
|
|
26
26
|
System:
|
|
27
|
-
Rules:
|
|
27
|
+
Rules: 23 loaded (R000-R023)
|
|
28
28
|
|
|
29
29
|
Agents:
|
|
30
|
-
|
|
31
|
-
Manager: 3 (mgr-creator, mgr-updater, mgr-supplier)
|
|
32
|
-
SW Engineer: 6
|
|
33
|
-
Backend Engineer: 3
|
|
34
|
-
Infra Engineer: 2
|
|
35
|
-
Total: 15 agents
|
|
30
|
+
Total: 50 agents
|
|
36
31
|
|
|
37
32
|
Skills:
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
Total:
|
|
33
|
+
Best Practices: 24
|
|
34
|
+
Workflow: 14
|
|
35
|
+
Other: 84
|
|
36
|
+
Total: 122 skills
|
|
42
37
|
|
|
43
|
-
Guides:
|
|
44
|
-
Commands:
|
|
38
|
+
Guides: 52 loaded
|
|
39
|
+
Commands: 60+ available
|
|
45
40
|
|
|
46
41
|
Health: ✓ OK
|
|
47
42
|
```
|
package/templates/AGENTS.md.en
CHANGED
|
@@ -129,11 +129,11 @@ project/
|
|
|
129
129
|
+-- AGENTS.md # Entry point
|
|
130
130
|
+-- .codex/
|
|
131
131
|
| +-- agents/ # Subagent definitions (50 files)
|
|
132
|
-
| +-- rules/ # Global rules (R000-
|
|
132
|
+
| +-- rules/ # Global rules (R000-R023)
|
|
133
133
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
134
134
|
| +-- contexts/ # Context files (ecomode)
|
|
135
135
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # Installed skills (
|
|
136
|
+
| +-- skills/ # Installed skills (122 directories)
|
|
137
137
|
+-- guides/ # Reference docs (52 topics)
|
|
138
138
|
```
|
|
139
139
|
|
|
@@ -198,7 +198,7 @@ When Codex CLI's Agent Teams feature is enabled (`OMCODEX_AGENT_TEAMS=1`), activ
|
|
|
198
198
|
**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
|
|
199
199
|
See R018 (MUST-agent-teams.md) for the decision matrix.
|
|
200
200
|
Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
|
|
201
|
-
|
|
201
|
+
Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
202
202
|
|
|
203
203
|
## Quick Reference
|
|
204
204
|
|
package/templates/AGENTS.md.ko
CHANGED
|
@@ -129,11 +129,11 @@ project/
|
|
|
129
129
|
+-- AGENTS.md # 진입점
|
|
130
130
|
+-- .codex/
|
|
131
131
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
132
|
-
| +-- rules/ # 전역 규칙 (R000-
|
|
132
|
+
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
133
133
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
134
134
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
135
135
|
+-- .agents/
|
|
136
|
-
| +-- skills/ # 설치된 스킬 (
|
|
136
|
+
| +-- skills/ # 설치된 스킬 (122 디렉토리)
|
|
137
137
|
+-- guides/ # 레퍼런스 문서 (52 토픽)
|
|
138
138
|
```
|
|
139
139
|
|
|
@@ -198,7 +198,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
198
198
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
199
199
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
200
200
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
201
|
-
단순/비용 민감 작업에는
|
|
201
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
202
202
|
|
|
203
203
|
## 빠른 참조
|
|
204
204
|
|
package/templates/CLAUDE.md
CHANGED
|
@@ -115,11 +115,11 @@ project/
|
|
|
115
115
|
+-- AGENTS.md # 진입점
|
|
116
116
|
+-- .codex/
|
|
117
117
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
118
|
-
| +-- rules/ # 전역 규칙 (R000-
|
|
118
|
+
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
119
119
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
120
120
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
121
121
|
+-- .agents/
|
|
122
|
-
| +-- skills/ # 스킬 (
|
|
122
|
+
| +-- skills/ # 스킬 (122 디렉토리)
|
|
123
123
|
+-- guides/ # 레퍼런스 문서 (52 토픽)
|
|
124
124
|
```
|
|
125
125
|
|
|
@@ -193,7 +193,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
193
193
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
194
194
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
195
195
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
196
|
-
단순/비용 민감 작업에는
|
|
196
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
197
197
|
|
|
198
198
|
## 빠른 참조
|
|
199
199
|
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -132,7 +132,7 @@ project/
|
|
|
132
132
|
+-- AGENTS.md # Entry point
|
|
133
133
|
+-- .codex/
|
|
134
134
|
| +-- agents/ # Subagent definitions (50 files)
|
|
135
|
-
| +-- skills/ # Skills (
|
|
135
|
+
| +-- skills/ # Skills (122 directories)
|
|
136
136
|
| +-- rules/ # Global rules (22 files)
|
|
137
137
|
| +-- hooks/ # Hook scripts (security, validation, HUD)
|
|
138
138
|
| +-- contexts/ # Context files (4 files)
|
|
@@ -194,7 +194,7 @@ When Codex CLI's Agent Teams feature is enabled (`OMCODEX_AGENT_TEAMS=1`), activ
|
|
|
194
194
|
**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
|
|
195
195
|
See R018 (MUST-agent-teams.md) for the decision matrix.
|
|
196
196
|
Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
|
|
197
|
-
|
|
197
|
+
Codex native subagents plus routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
198
198
|
|
|
199
199
|
## Quick Reference
|
|
200
200
|
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -132,7 +132,7 @@ project/
|
|
|
132
132
|
+-- AGENTS.md # 진입점
|
|
133
133
|
+-- .codex/
|
|
134
134
|
| +-- agents/ # 서브에이전트 정의 (50 파일)
|
|
135
|
-
| +-- skills/ # 스킬 (
|
|
135
|
+
| +-- skills/ # 스킬 (122 디렉토리)
|
|
136
136
|
| +-- rules/ # 전역 규칙 (22 파일)
|
|
137
137
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
138
138
|
| +-- contexts/ # 컨텍스트 파일 (4 파일)
|
|
@@ -194,7 +194,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
|
|
|
194
194
|
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
195
195
|
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
196
196
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
197
|
-
단순/비용 민감 작업에는
|
|
197
|
+
단순/비용 민감 작업에는 Codex native subagents와 라우팅 스킬이 폴백으로 유지됩니다.
|
|
198
198
|
|
|
199
199
|
## 빠른 참조
|
|
200
200
|
|
|
@@ -38,17 +38,17 @@ The R012 statusline already covers: Cost, Rate Limit %, Weekly Limit %, Context
|
|
|
38
38
|
|
|
39
39
|
### SubTask Delegation (R009/R010/R018 Priority)
|
|
40
40
|
|
|
41
|
-
cc-token-saver's Smart Session Architecture
|
|
41
|
+
cc-token-saver's Smart Session Architecture may inject legacy SubTask delegation patterns. oh-my-customcodex translates those to its own Codex-native delegation rules (R010) and parallel execution rules (R009/R018).
|
|
42
42
|
|
|
43
43
|
**Resolution**: Internal rules always take precedence (R010 External Skills vs Internal Rules).
|
|
44
44
|
|
|
45
45
|
| cc-token-saver suggests | oh-my-customcodex rule |
|
|
46
46
|
|-------------------------|----------------------|
|
|
47
|
-
| Use SubTask for delegation |
|
|
47
|
+
| Use SubTask for delegation | Codex native subagents via routing skills (R010) |
|
|
48
48
|
| Sequential delegation pattern | Parallel when independent (R009) |
|
|
49
49
|
| Generic subtask agent | Specialized agent by domain (R010) |
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
Treat cc-token-saver's SubTask suggestions as legacy Claude wording; use Codex native subagents when they do not conflict with R009/R010/R018.
|
|
52
52
|
|
|
53
53
|
### Token Guardian ↔ R013 context-budget-advisor.sh (Coexistence)
|
|
54
54
|
|
|
@@ -102,5 +102,5 @@ Reports your current rate limit hit to the community pool and shows aggregate ra
|
|
|
102
102
|
|
|
103
103
|
- R013 ecomode and Token Guardian are complementary, not competing
|
|
104
104
|
- R012 statusline supersedes cc-token-saver's Live Status Line
|
|
105
|
-
- R009/R010/R018 delegation rules override cc-token-saver's SubTask patterns
|
|
105
|
+
- R009/R010/R018 delegation rules translate or override cc-token-saver's legacy SubTask patterns
|
|
106
106
|
- `/continue`, `/usage-view`, `/report-limit` have no conflicts with internal rules — use freely
|
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
This guide records Claude Code release-note impact that affects the Claude compatibility template. The Codex-native runtime still uses `.codex/**` and OMX as the primary surface.
|
|
4
4
|
|
|
5
|
+
## v2.1.178
|
|
6
|
+
|
|
7
|
+
Published: 2026-06-15.
|
|
8
|
+
|
|
9
|
+
Source: upstream oh-my-customcode v1.0.9 / #1391, Codex-port issue #1524.
|
|
10
|
+
|
|
11
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
12
|
+
|--------|------------------------------|--------|
|
|
13
|
+
| Permission rules support `Tool(param:value)` with `*` wildcards, such as `Agent(model:opus)` | Claude compatibility settings can now deny a specific tool-parameter shape instead of only a tool name. This complements `availableModels` and explicit subagent permission-mode guidance, but Codex/OMX sandboxing remains the active runtime boundary here. | Document as Claude-template R002 compatibility; do not translate Claude permission syntax into Codex policy. |
|
|
14
|
+
| Compaction honors the configured `fallbackModel` chain on overload or availability errors | Claude compatibility sessions using fallback models are less likely to fail during compaction. This extends the v2.1.166 fallback behavior to the compaction path. | Document under Claude agent/model compatibility; keep Codex subagent routing on OMX model metadata and `reasoning_effort`. |
|
|
15
|
+
| Nested `.claude/skills` directories load for files in that subtree, name collisions surface as `<dir>:<name>`, and directory-qualified skills avoid non-interactive permission prompts | Nested Claude template trees can coexist with root skills without silently hiding same-named entries. | Keep this package's installed `.codex/**` and flat template layout primary; mention the nested Claude behavior only for compatibility sessions. |
|
|
16
|
+
| Subagent `disallowedTools` now honors MCP-spec entries such as `mcp__server`, `mcp__server__*`, and `mcp__*` | Claude subagent frontmatter can constrain MCP surfaces that were previously ignored. | Record as Claude R006 compatibility; continue using repo-owned Codex/OMX tool boundaries for this package. |
|
|
17
|
+
| When nested `.claude/` definitions collide, the closest agent, workflow, or output-style to the working directory wins; project-scope workflow saves target the closest existing `.claude/workflows/` | Monorepo Claude compatibility sessions may resolve names differently from root-only assumptions. | Document closest-wins behavior; avoid inferring Codex skill/workflow precedence from it. |
|
|
18
|
+
| Auto mode evaluates subagent spawns with the safety classifier before launch | Claude adds a platform-level pre-launch gate for subagent actions. It complements, but does not replace, prompt-level scope boundaries. | Keep pre-delegation scope statements in guidance; treat classifier gating as defense-in-depth for Claude sessions only. |
|
|
19
|
+
| `claude agents` workers behind `ANTHROPIC_BASE_URL` + `ANTHROPIC_AUTH_TOKEN` no longer fail with `401 Invalid bearer token`; `/bg` sessions no longer show `Working` forever after completion | Reduces false blockers in Claude background-agent and custom-gateway workflows. | Document as Claude background-agent reliability; no Codex runtime or package source change. |
|
|
20
|
+
|
|
5
21
|
## v2.1.177
|
|
6
22
|
|
|
7
23
|
| Change | Impact | oh-my-customcodex action |
|
|
@@ -2,6 +2,36 @@
|
|
|
2
2
|
|
|
3
3
|
This guide records OpenAI Codex release-note impact decisions for oh-my-customcodex. Use it for Codex/OMX runtime compatibility notes; keep Claude-only release notes in `guides/claude-code/15-version-compatibility.md`.
|
|
4
4
|
|
|
5
|
+
## oh-my-codex v0.18.17 / OMX baseline
|
|
6
|
+
|
|
7
|
+
Source: upstream oh-my-codex release `v0.18.17`, Codex-port issue #1556.
|
|
8
|
+
|
|
9
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
10
|
+
| --- | --- | --- |
|
|
11
|
+
| Ultragoal null `get_goal` loop recovery, Ralplan/planning-gate state-write guards, and stop-keyword path false-positive fixes | These are upstream OMX runtime safety fixes for workflows this package delegates to rather than reimplementing locally. | Raise the packaged `MINIMUM_OMX_VERSION` to `0.18.17` so `init`, `update`, and `doctor` require the fixed runtime instead of copying runtime internals into this child package. |
|
|
12
|
+
| Team worker startup path fixes for MSYS, Windows psmux question rendering, exact-role worker CLI resolution, and tmux-session test hardening | Cross-platform Team/Question behavior belongs to the installed OMX runtime; local repo has no `src/team`, `src/question`, or `ultragoal` engine surface to patch. | Treat as runtime dependency compatibility; `omcustomcodex doctor` now flags older OMX installs as stale. |
|
|
13
|
+
| Auth slot isolation/invalid token rotation and notification fallback fixes | Operational reliability improvements in upstream runtime/auth layers. | Covered by the baseline bump; no package-owned credential or notification implementation copied. |
|
|
14
|
+
| Docs/dependency/model-table release churn | No direct package-owned behavior unless this repo mirrors that runtime metadata exactly. | Skip as source changes; keep this compatibility record as evidence. |
|
|
15
|
+
|
|
16
|
+
## rust-v0.141.0 / CLI 0.141.0
|
|
17
|
+
|
|
18
|
+
Source: upstream OpenAI Codex release `rust-v0.141.0`, Codex-port issue #1526.
|
|
19
|
+
|
|
20
|
+
| Change | Impact on oh-my-customcodex | Action |
|
|
21
|
+
| --- | --- | --- |
|
|
22
|
+
| Remote executors use authenticated end-to-end encrypted Noise relay channels | Strengthens Codex remote execution transport without changing package-owned templates or CLI behavior. | Record compatibility; no package dependency or config migration required. |
|
|
23
|
+
| Cross-platform remote execution preserves executor-native working directories, shells, and filesystem permission paths across app-server and exec-server boundaries | Reduces path/shell mismatch during Codex runtime sessions, especially remote or mixed-platform work. | Keep repo guidance path-explicit and verify local evidence; no source change. |
|
|
24
|
+
| Selected executor plugins can activate stdio MCP servers per thread; plugin discovery adds created-by-me marketplace and auth-specific curated catalogs | Improves runtime plugin/MCP availability and inventory vocabulary. | Continue treating connector schemas and selected plugins as runtime ground truth; no packaged skill migration. |
|
|
25
|
+
| App-server clients can list immediate child threads, correlate external-agent imports with detailed results, and read or redeem rate-limit reset credits | Adds observability for app-server and external-agent workflows. | Mention as external runtime capability; package workflows still require local artifact/evidence checks before completion claims. |
|
|
26
|
+
| Realtime clients can append speech explicitly, control how Codex responses enter conversations, and omit startup context | Realtime behavior improves outside this package's installed documentation/runtime surface. | No package action beyond this compatibility record. |
|
|
27
|
+
| TUI input prompts can auto-resolve after inactivity with a countdown that pauses on interaction | Aligns with non-blocking prompt behavior for Codex sessions. | Keep asking only for materially blocking input; no package workflow change. |
|
|
28
|
+
| Hook trust bypass persists through `codex exec` thread start/resume, and blocking `PostToolUse` hooks reject code-mode tool calls correctly | Hardens Codex hook boundaries relevant to repository safety guidance. | Preserve repo hook/safety guidance; no `omcustomcodex` source change required. |
|
|
29
|
+
| Plugin capabilities route by authentication mode, deduplicate conflicting App/MCP declarations, and preserve remote marketplace ordering | Reduces duplicate or misrouted tool exposure in plugin-heavy sessions. | Prefer runtime connector/tool metadata as the source of truth; no template change. |
|
|
30
|
+
| Windows sandbox execution repairs stale credentials and gives PowerShell commands more time before backgrounding | Improves Windows reliability for Codex runtime users. | No package migration; continue documenting shell-specific assumptions explicitly. |
|
|
31
|
+
| Idle exec-server relays stay connected and steered user input interrupts `wait_agent` immediately | Reduces false blockers in long-running or multi-agent Codex sessions. | No package action beyond compatibility tracking. |
|
|
32
|
+
| Bundled SQLite is pinned to a WAL-reset corruption fix; TLS supports P-521 certificate signatures used by enterprise proxies | Improves storage/network reliability under Codex itself. | No package dependency change; keep credential and enterprise-proxy diagnostics metadata-only. |
|
|
33
|
+
| Tool-search caching, request/history copy reduction, bounded prompt-image cache, bounded feedback upload subtrees, and always-on terminal resize reflow reduce latency, memory, and stale UI behavior | Runtime performance and UX improvements may make documentation/test sessions less fragile. | No source/runtime change in this package. |
|
|
34
|
+
|
|
5
35
|
## rust-v0.140.0 / CLI 0.140.0
|
|
6
36
|
|
|
7
37
|
Source: upstream OpenAI Codex release `rust-v0.140.0`, Codex-port issue #1522.
|
package/templates/manifest.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.0.
|
|
2
|
+
"version": "1.0.5",
|
|
3
3
|
"requiresCC": ">=2.1.121",
|
|
4
4
|
"claudeCode": {
|
|
5
5
|
"minimumVersion": "2.1.121",
|
|
6
6
|
"protectedPathBypassVersion": "2.1.126"
|
|
7
7
|
},
|
|
8
|
-
"lastUpdated": "2026-
|
|
8
|
+
"lastUpdated": "2026-07-04",
|
|
9
9
|
"components": [
|
|
10
10
|
{
|
|
11
11
|
"name": "rules",
|