oh-my-customcode 0.12.1 → 0.12.3

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.
Files changed (134) hide show
  1. package/README.md +8 -11
  2. package/dist/cli/index.js +137 -336
  3. package/dist/index.js +99 -260
  4. package/package.json +2 -4
  5. package/templates/.claude/skills/codex-exec/SKILL.md +123 -0
  6. package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +413 -0
  7. package/templates/CLAUDE.md.en +1 -0
  8. package/templates/CLAUDE.md.ko +1 -0
  9. package/templates/.codex/agents/arch-documenter.md +0 -33
  10. package/templates/.codex/agents/arch-speckit-agent.md +0 -47
  11. package/templates/.codex/agents/be-express-expert.md +0 -30
  12. package/templates/.codex/agents/be-fastapi-expert.md +0 -43
  13. package/templates/.codex/agents/be-go-backend-expert.md +0 -43
  14. package/templates/.codex/agents/be-nestjs-expert.md +0 -28
  15. package/templates/.codex/agents/be-springboot-expert.md +0 -40
  16. package/templates/.codex/agents/db-postgres-expert.md +0 -36
  17. package/templates/.codex/agents/db-redis-expert.md +0 -36
  18. package/templates/.codex/agents/db-supabase-expert.md +0 -35
  19. package/templates/.codex/agents/de-airflow-expert.md +0 -34
  20. package/templates/.codex/agents/de-dbt-expert.md +0 -34
  21. package/templates/.codex/agents/de-kafka-expert.md +0 -81
  22. package/templates/.codex/agents/de-pipeline-expert.md +0 -32
  23. package/templates/.codex/agents/de-snowflake-expert.md +0 -36
  24. package/templates/.codex/agents/de-spark-expert.md +0 -36
  25. package/templates/.codex/agents/fe-svelte-agent.md +0 -29
  26. package/templates/.codex/agents/fe-vercel-agent.md +0 -37
  27. package/templates/.codex/agents/fe-vuejs-agent.md +0 -30
  28. package/templates/.codex/agents/infra-aws-expert.md +0 -47
  29. package/templates/.codex/agents/infra-docker-expert.md +0 -47
  30. package/templates/.codex/agents/lang-golang-expert.md +0 -43
  31. package/templates/.codex/agents/lang-java21-expert.md +0 -39
  32. package/templates/.codex/agents/lang-kotlin-expert.md +0 -43
  33. package/templates/.codex/agents/lang-python-expert.md +0 -43
  34. package/templates/.codex/agents/lang-rust-expert.md +0 -43
  35. package/templates/.codex/agents/lang-typescript-expert.md +0 -43
  36. package/templates/.codex/agents/mgr-claude-code-bible.md +0 -58
  37. package/templates/.codex/agents/mgr-creator.md +0 -39
  38. package/templates/.codex/agents/mgr-gitnerd.md +0 -45
  39. package/templates/.codex/agents/mgr-sauron.md +0 -161
  40. package/templates/.codex/agents/mgr-supplier.md +0 -35
  41. package/templates/.codex/agents/mgr-sync-checker.md +0 -38
  42. package/templates/.codex/agents/mgr-updater.md +0 -33
  43. package/templates/.codex/agents/qa-engineer.md +0 -32
  44. package/templates/.codex/agents/qa-planner.md +0 -73
  45. package/templates/.codex/agents/qa-writer.md +0 -27
  46. package/templates/.codex/agents/sys-memory-keeper.md +0 -43
  47. package/templates/.codex/agents/sys-naggy.md +0 -37
  48. package/templates/.codex/agents/tool-bun-expert.md +0 -26
  49. package/templates/.codex/agents/tool-npm-expert.md +0 -30
  50. package/templates/.codex/agents/tool-optimizer.md +0 -34
  51. package/templates/.codex/codex-native-hash.txt +0 -1
  52. package/templates/.codex/contexts/dev.md +0 -20
  53. package/templates/.codex/contexts/ecomode.md +0 -63
  54. package/templates/.codex/contexts/index.yaml +0 -41
  55. package/templates/.codex/contexts/research.md +0 -28
  56. package/templates/.codex/contexts/review.md +0 -23
  57. package/templates/.codex/hooks/hooks.json +0 -150
  58. package/templates/.codex/install-hooks.sh +0 -100
  59. package/templates/.codex/rules/MAY-optimization.md +0 -29
  60. package/templates/.codex/rules/MUST-agent-design.md +0 -57
  61. package/templates/.codex/rules/MUST-agent-identification.md +0 -29
  62. package/templates/.codex/rules/MUST-continuous-improvement.md +0 -25
  63. package/templates/.codex/rules/MUST-intent-transparency.md +0 -42
  64. package/templates/.codex/rules/MUST-language-policy.md +0 -27
  65. package/templates/.codex/rules/MUST-orchestrator-coordination.md +0 -128
  66. package/templates/.codex/rules/MUST-parallel-execution.md +0 -97
  67. package/templates/.codex/rules/MUST-permissions.md +0 -30
  68. package/templates/.codex/rules/MUST-safety.md +0 -23
  69. package/templates/.codex/rules/MUST-sync-verification.md +0 -125
  70. package/templates/.codex/rules/MUST-tool-identification.md +0 -82
  71. package/templates/.codex/rules/SHOULD-agent-teams.md +0 -39
  72. package/templates/.codex/rules/SHOULD-ecomode.md +0 -37
  73. package/templates/.codex/rules/SHOULD-error-handling.md +0 -33
  74. package/templates/.codex/rules/SHOULD-hud-statusline.md +0 -32
  75. package/templates/.codex/rules/SHOULD-interaction.md +0 -34
  76. package/templates/.codex/rules/SHOULD-memory-integration.md +0 -39
  77. package/templates/.codex/rules/index.yaml +0 -141
  78. package/templates/.codex/skills/airflow-best-practices/SKILL.md +0 -56
  79. package/templates/.codex/skills/audit-agents/SKILL.md +0 -116
  80. package/templates/.codex/skills/aws-best-practices/SKILL.md +0 -280
  81. package/templates/.codex/skills/claude-code-bible/SKILL.md +0 -100
  82. package/templates/.codex/skills/claude-code-bible/scripts/fetch-docs.js +0 -272
  83. package/templates/.codex/skills/create-agent/SKILL.md +0 -91
  84. package/templates/.codex/skills/dbt-best-practices/SKILL.md +0 -54
  85. package/templates/.codex/skills/de-lead-routing/SKILL.md +0 -243
  86. package/templates/.codex/skills/dev-lead-routing/SKILL.md +0 -94
  87. package/templates/.codex/skills/dev-refactor/SKILL.md +0 -123
  88. package/templates/.codex/skills/dev-review/SKILL.md +0 -81
  89. package/templates/.codex/skills/docker-best-practices/SKILL.md +0 -275
  90. package/templates/.codex/skills/fastapi-best-practices/SKILL.md +0 -270
  91. package/templates/.codex/skills/fix-refs/SKILL.md +0 -107
  92. package/templates/.codex/skills/go-backend-best-practices/SKILL.md +0 -338
  93. package/templates/.codex/skills/go-best-practices/SKILL.md +0 -203
  94. package/templates/.codex/skills/help/SKILL.md +0 -125
  95. package/templates/.codex/skills/intent-detection/SKILL.md +0 -215
  96. package/templates/.codex/skills/intent-detection/patterns/agent-triggers.yaml +0 -349
  97. package/templates/.codex/skills/kafka-best-practices/SKILL.md +0 -52
  98. package/templates/.codex/skills/kotlin-best-practices/SKILL.md +0 -256
  99. package/templates/.codex/skills/lists/SKILL.md +0 -78
  100. package/templates/.codex/skills/memory-management/SKILL.md +0 -195
  101. package/templates/.codex/skills/memory-recall/SKILL.md +0 -152
  102. package/templates/.codex/skills/memory-save/SKILL.md +0 -126
  103. package/templates/.codex/skills/monitoring-setup/SKILL.md +0 -115
  104. package/templates/.codex/skills/npm-audit/SKILL.md +0 -72
  105. package/templates/.codex/skills/npm-publish/SKILL.md +0 -63
  106. package/templates/.codex/skills/npm-version/SKILL.md +0 -75
  107. package/templates/.codex/skills/optimize-analyze/SKILL.md +0 -55
  108. package/templates/.codex/skills/optimize-bundle/SKILL.md +0 -67
  109. package/templates/.codex/skills/optimize-report/SKILL.md +0 -74
  110. package/templates/.codex/skills/pipeline-architecture-patterns/SKILL.md +0 -83
  111. package/templates/.codex/skills/postgres-best-practices/SKILL.md +0 -66
  112. package/templates/.codex/skills/python-best-practices/SKILL.md +0 -222
  113. package/templates/.codex/skills/qa-lead-routing/SKILL.md +0 -290
  114. package/templates/.codex/skills/react-best-practices/SKILL.md +0 -101
  115. package/templates/.codex/skills/redis-best-practices/SKILL.md +0 -83
  116. package/templates/.codex/skills/result-aggregation/SKILL.md +0 -164
  117. package/templates/.codex/skills/rust-best-practices/SKILL.md +0 -267
  118. package/templates/.codex/skills/sauron-watch/SKILL.md +0 -144
  119. package/templates/.codex/skills/secretary-routing/SKILL.md +0 -203
  120. package/templates/.codex/skills/snowflake-best-practices/SKILL.md +0 -65
  121. package/templates/.codex/skills/spark-best-practices/SKILL.md +0 -52
  122. package/templates/.codex/skills/springboot-best-practices/SKILL.md +0 -218
  123. package/templates/.codex/skills/status/SKILL.md +0 -153
  124. package/templates/.codex/skills/supabase-postgres-best-practices/SKILL.md +0 -99
  125. package/templates/.codex/skills/typescript-best-practices/SKILL.md +0 -321
  126. package/templates/.codex/skills/update-docs/SKILL.md +0 -140
  127. package/templates/.codex/skills/update-external/SKILL.md +0 -149
  128. package/templates/.codex/skills/vercel-deploy/SKILL.md +0 -73
  129. package/templates/.codex/skills/web-design-guidelines/SKILL.md +0 -118
  130. package/templates/.codex/skills/writing-clearly-and-concisely/SKILL.md +0 -64
  131. package/templates/.codex/uninstall-hooks.sh +0 -52
  132. package/templates/AGENTS.md.en +0 -39
  133. package/templates/AGENTS.md.ko +0 -39
  134. package/templates/manifest.codex.json +0 -43
@@ -1,78 +0,0 @@
1
- ---
2
- name: lists
3
- description: Show all available commands
4
- argument-hint: "[--category <category>] [--verbose]"
5
- ---
6
-
7
- # List Commands Skill
8
-
9
- Show all available commands with optional filtering and detailed information.
10
-
11
- ## Options
12
-
13
- ```
14
- --verbose, -v Show detailed descriptions
15
- --category, -c Filter by category (system, manager, dev)
16
- ```
17
-
18
- ## Output Format
19
-
20
- ### Default
21
- ```
22
- AI Agent System - Available Commands
23
-
24
- System:
25
- lists Show all available commands
26
- status Show system status
27
- help Show help information
28
-
29
- Manager:
30
- /create-agent Create a new agent
31
- /update-docs Sync documentation with project structure
32
- /update-external Update agents from external sources
33
- /audit-agents Audit agent dependencies
34
- /fix-refs Fix broken references
35
-
36
- Dev:
37
- /dev-review Review code for best practices
38
- /dev-refactor Refactor code
39
-
40
- Use "<command> --help" for detailed information.
41
- ```
42
-
43
- ### Verbose Output
44
- ```
45
- lists --verbose
46
-
47
- AI Agent System - Available Commands (Detailed)
48
-
49
- System Commands:
50
- ┌─────────┬──────────────────────────────────────────────┐
51
- │ Command │ Description │
52
- ├─────────┼──────────────────────────────────────────────┤
53
- │ lists │ Show all available commands │
54
- │ status │ Show system status and health checks │
55
- │ help │ Show help for commands and agents │
56
- └─────────┴──────────────────────────────────────────────┘
57
-
58
- Manager Commands:
59
- ┌──────────────────┬──────────────────────────────────────┐
60
- │ Command │ Description │
61
- ├──────────────────┼──────────────────────────────────────┤
62
- │ /create-agent │ Create a new agent with structure │
63
- │ /update-docs │ Sync all docs with project state │
64
- │ /update-external │ Update from external sources │
65
- │ /audit-agents │ Check dependencies and refs │
66
- │ /fix-refs │ Auto-fix broken references │
67
- └──────────────────┴──────────────────────────────────────┘
68
-
69
- Dev Commands:
70
- ┌──────────────┬────────────────────────────────────────┐
71
- │ Command │ Description │
72
- ├──────────────┼────────────────────────────────────────┤
73
- │ /dev-review │ Review code against best practices │
74
- │ /dev-refactor│ Suggest and apply refactoring │
75
- └──────────────┴────────────────────────────────────────┘
76
-
77
- Total: 10 commands available
78
- ```
@@ -1,195 +0,0 @@
1
- ---
2
- name: memory-management
3
- description: Memory persistence operations using claude-mem
4
- user-invocable: false
5
- ---
6
-
7
- ## Purpose
8
-
9
- Provide memory persistence operations using claude-mem for session context survival across compactions.
10
-
11
- ## Operations
12
-
13
- ### 1. Save Context
14
-
15
- ```yaml
16
- operation: save
17
- description: Store session context in claude-mem
18
- steps:
19
- 1. Collect session data:
20
- - Tasks completed
21
- - Decisions made
22
- - Open items
23
- - Key code changes
24
- 2. Format document:
25
- - Add project tag: "my-project"
26
- - Add session ID: {date}-{uuid}
27
- - Add relevant tags
28
- 3. Store in claude-mem:
29
- - Use chroma_add_documents
30
- - Include metadata
31
- ```
32
-
33
- ### 2. Recall Context
34
-
35
- ```yaml
36
- operation: recall
37
- description: Search and retrieve relevant memories
38
- steps:
39
- 1. Build query:
40
- - Always prefix with "my-project"
41
- - Add user-provided search terms
42
- - Include date for temporal searches
43
- 2. Search claude-mem:
44
- - Use chroma_query_documents
45
- - Request top N results
46
- 3. Format results:
47
- - Sort by relevance
48
- - Present summary
49
- - Provide access to full content
50
- ```
51
-
52
- ### 3. Get Specific Memory
53
-
54
- ```yaml
55
- operation: get
56
- description: Retrieve specific memory by ID
57
- steps:
58
- 1. Use chroma_get_documents with ID
59
- 2. Return full document content
60
- ```
61
-
62
- ## Query Patterns
63
-
64
- ### Semantic Search (Primary)
65
-
66
- ```python
67
- # Always include project name
68
- chroma_query_documents(["my-project {search_terms}"])
69
-
70
- # Examples:
71
- chroma_query_documents(["my-project authentication flow"])
72
- chroma_query_documents(["my-project 2025-01-24 memory system"])
73
- ```
74
-
75
- ### Get by ID
76
-
77
- ```python
78
- # When you have a specific document ID
79
- chroma_get_documents(ids=["document_id"])
80
- ```
81
-
82
- ## Document Format
83
-
84
- ### Save Format
85
-
86
- ```yaml
87
- content: |
88
- ## Session Summary
89
- Date: {date}
90
- Session: {session_id}
91
-
92
- ### Tasks Completed
93
- - Task 1: Description
94
- - Task 2: Description
95
-
96
- ### Decisions Made
97
- - Decision 1: Rationale
98
- - Decision 2: Rationale
99
-
100
- ### Open Items
101
- - Item 1: Status
102
- - Item 2: Status
103
-
104
- ### Notes
105
- Additional context...
106
-
107
- metadata:
108
- project: my-project
109
- session: {date}-{uuid}
110
- tags: [session, task, decision, ...]
111
- created_at: {timestamp}
112
- ```
113
-
114
- ### Recall Response Format
115
-
116
- ```yaml
117
- results:
118
- - id: doc_1
119
- score: 0.95
120
- summary: "Authentication flow implementation"
121
- date: 2025-01-20
122
- tags: [authentication, oauth]
123
- - id: doc_2
124
- score: 0.87
125
- summary: "JWT token decision"
126
- date: 2025-01-18
127
- tags: [authentication, decision]
128
- ```
129
-
130
- ## Best Practices
131
-
132
- ### Query Tips
133
-
134
- ```yaml
135
- do:
136
- - Always include "my-project" prefix
137
- - Use semantic, intent-based queries
138
- - Include dates for temporal searches
139
- - Use multiple queries for better coverage
140
-
141
- dont:
142
- - Use complex where filters ($and, $or)
143
- - Omit project name
144
- - Use overly generic terms
145
- - Expect exact string matching
146
- ```
147
-
148
- ### Save Tips
149
-
150
- ```yaml
151
- do:
152
- - Include meaningful tags
153
- - Write clear summaries
154
- - Capture decisions with rationale
155
- - Note open items for future reference
156
-
157
- dont:
158
- - Save trivial conversations
159
- - Include sensitive data (API keys, etc.)
160
- - Create duplicate entries
161
- ```
162
-
163
- ## Integration
164
-
165
- ### With sys-memory-keeper Agent
166
-
167
- ```
168
- sys-memory-keeper agent uses this skill for:
169
- - sys-memory-keeper:save command
170
- - sys-memory-keeper:recall command
171
- - PreCompact hook
172
- - SessionStart hook
173
- ```
174
-
175
- ### With Other Agents
176
-
177
- ```
178
- Other agents can trigger memory operations via:
179
- - Direct sys-memory-keeper:save/recall commands
180
- - Delegating to sys-memory-keeper
181
- ```
182
-
183
- ## Error Handling
184
-
185
- ```yaml
186
- save_errors:
187
- - Connection failure: Retry 3 times, then log and continue
188
- - Invalid format: Validate before save, report issues
189
- - Storage full: Archive old memories, then retry
190
-
191
- recall_errors:
192
- - No results: Suggest alternative queries
193
- - Connection failure: Return empty with warning
194
- - Invalid query: Help user reformulate
195
- ```
@@ -1,152 +0,0 @@
1
- ---
2
- name: memory-recall
3
- description: Search and recall memories from claude-mem
4
- argument-hint: "<query> [--recent] [--limit <n>]"
5
- ---
6
-
7
- # Memory Recall Skill
8
-
9
- Search and recall relevant memories from claude-mem using semantic search.
10
-
11
- ## Parameters
12
-
13
- | Name | Type | Required | Description |
14
- |------|------|----------|-------------|
15
- | query | string | yes* | Search query (*not required with --recent) |
16
-
17
- ## Options
18
-
19
- ```
20
- --recent, -r Recall most recent memories
21
- --limit, -l Maximum results to return (default: 5)
22
- --verbose, -v Show full memory content
23
- --date, -d Filter by date (YYYY-MM-DD)
24
- ```
25
-
26
- ## Workflow
27
-
28
- ```
29
- 1. Build semantic query
30
- ├── Prefix with "my-project"
31
- ├── Add user query terms
32
- └── Include date if specified
33
-
34
- 2. Search claude-mem
35
- └── chroma_query_documents
36
-
37
- 3. Format results
38
- ├── Sort by relevance score
39
- ├── Show summary for each
40
- └── Provide memory IDs for detailed access
41
-
42
- 4. Present to user
43
- ```
44
-
45
- ## Query Tips
46
-
47
- ```yaml
48
- effective_queries:
49
- - "authentication flow" (topic-based)
50
- - "2025-01-20 oauth" (temporal + topic)
51
- - "decision jwt" (type + topic)
52
- - "agent creation workflow" (semantic intent)
53
-
54
- avoid:
55
- - Single generic words like "code" or "task"
56
- - Very long queries (keep it focused)
57
- - Special characters or complex syntax
58
- ```
59
-
60
- ## Output Format
61
-
62
- ### Basic Search
63
- ```
64
- [sys-memory-keeper:recall authentication]
65
-
66
- Searching memories for: "my-project authentication"
67
-
68
- Found 3 relevant memories:
69
-
70
- [1] mem_abc123 (Score: 0.95)
71
- Date: 2025-01-20
72
- Summary: Implemented OAuth flow with Google provider
73
- Tags: [authentication, oauth, google]
74
-
75
- [2] mem_def456 (Score: 0.87)
76
- Date: 2025-01-18
77
- Summary: JWT token decision - RS256 algorithm
78
- Tags: [authentication, decision, jwt]
79
-
80
- [3] mem_ghi789 (Score: 0.82)
81
- Date: 2025-01-15
82
- Summary: Authentication architecture discussion
83
- Tags: [authentication, architecture, planning]
84
-
85
- Use "sys-memory-keeper:recall --verbose" for full content.
86
- ```
87
-
88
- ### Verbose Output
89
- ```
90
- [sys-memory-keeper:recall authentication --verbose]
91
-
92
- Searching memories for: "my-project authentication"
93
-
94
- [1] mem_abc123 (Score: 0.95)
95
- Date: 2025-01-20
96
- Tags: [authentication, oauth, google]
97
-
98
- Content:
99
- ## Session Summary
100
- Date: 2025-01-20
101
-
102
- ### Tasks Completed
103
- - Implemented OAuth flow with Google provider
104
- - Added callback handler for OAuth response
105
- - Created user session management
106
-
107
- ### Decisions Made
108
- - Use passport.js for OAuth handling
109
- Rationale: Well-maintained, good documentation
110
-
111
- ---
112
-
113
- [2] mem_def456 (Score: 0.87)
114
- ...
115
- ```
116
-
117
- ### Recent Memories
118
- ```
119
- [sys-memory-keeper:recall --recent]
120
-
121
- Fetching recent memories for: my-project
122
-
123
- [1] mem_xyz999 (Score: 1.00)
124
- Date: 2025-01-24
125
- Summary: Memory system Phase 1 implementation
126
- Tags: [session, memory, phase1]
127
-
128
- [2] mem_xyz888 (Score: 0.98)
129
- Date: 2025-01-23
130
- Summary: Agent identification rules update
131
- Tags: [session, rules, enforcement]
132
-
133
- ...
134
- ```
135
-
136
- ### No Results
137
- ```
138
- [sys-memory-keeper:recall "nonexistent topic"]
139
-
140
- Searching memories for: "my-project nonexistent topic"
141
-
142
- No memories found matching your query.
143
-
144
- Suggestions:
145
- - Try different keywords
146
- - Use broader search terms
147
- - Check available memories with "sys-memory-keeper:recall --recent"
148
- ```
149
-
150
- ## Related
151
-
152
- - memory-save - Save current context
@@ -1,126 +0,0 @@
1
- ---
2
- name: memory-save
3
- description: Save current session context to claude-mem
4
- argument-hint: "[--tags <tags>] [--include-code]"
5
- disable-model-invocation: true
6
- ---
7
-
8
- # Memory Save Skill
9
-
10
- Save current session context to claude-mem for persistence across context compaction.
11
-
12
- ## Options
13
-
14
- ```
15
- --tags, -t Additional tags for the memory
16
- --include-code Include code changes in the save
17
- --summary, -s Custom summary (otherwise auto-generated)
18
- --verbose, -v Show detailed save information
19
- ```
20
-
21
- ## Workflow
22
-
23
- ```
24
- 1. Collect session context
25
- ├── Tasks completed
26
- ├── Decisions made
27
- ├── Open items
28
- └── Code changes (if --include-code)
29
-
30
- 2. Format with metadata
31
- ├── project: my-project
32
- ├── session: {date}-{uuid}
33
- ├── tags: [session, ...user_tags]
34
- └── created_at: {timestamp}
35
-
36
- 3. Store in claude-mem
37
- └── chroma_add_documents
38
-
39
- 4. Report result
40
- ```
41
-
42
- ## Storage Format
43
-
44
- ```yaml
45
- project: my-project
46
- session: {date}-{uuid}
47
- tags: [session, task, decision]
48
- content:
49
- summary: Brief description of session context
50
- tasks_completed: List of completed tasks
51
- decisions: Key decisions made
52
- open_items: Unfinished work
53
- ```
54
-
55
- ## Output Format
56
-
57
- ### Success
58
- ```
59
- [sys-memory-keeper:save]
60
-
61
- Saving session context...
62
-
63
- Context collected:
64
- Tasks: 3 completed
65
- Decisions: 2 recorded
66
- Open items: 1 pending
67
-
68
- Metadata:
69
- Project: my-project
70
- Session: 2025-01-24-a1b2c3d4
71
- Tags: [session, task, decision]
72
-
73
- [Done] Session context saved successfully.
74
- Memory ID: mem_abc123
75
- ```
76
-
77
- ### With Tags
78
- ```
79
- [sys-memory-keeper:save --tags "authentication,oauth"]
80
-
81
- Saving session context...
82
-
83
- Metadata:
84
- Project: my-project
85
- Session: 2025-01-24-a1b2c3d4
86
- Tags: [session, task, decision, authentication, oauth]
87
-
88
- [Done] Session context saved successfully.
89
- Memory ID: mem_abc123
90
- ```
91
-
92
- ### Verbose
93
- ```
94
- [sys-memory-keeper:save --verbose]
95
-
96
- Collecting session context...
97
-
98
- Tasks Completed:
99
- 1. Implemented OAuth flow
100
- 2. Added JWT token validation
101
- 3. Created authentication middleware
102
-
103
- Decisions Made:
104
- 1. Use RS256 for JWT signing
105
- Rationale: Better security for distributed systems
106
- 2. Token expiry: 1 hour
107
- Rationale: Balance security and user experience
108
-
109
- Open Items:
110
- 1. Refresh token implementation
111
- Status: In progress
112
-
113
- Saving to claude-mem...
114
-
115
- Document content:
116
- ## Session Summary
117
- Date: 2025-01-24
118
- ...
119
-
120
- [Done] Session context saved.
121
- Memory ID: mem_abc123
122
- ```
123
-
124
- ## Related
125
-
126
- - memory-recall - Search and recall memories
@@ -1,115 +0,0 @@
1
- ---
2
- name: monitoring-setup
3
- description: Enable/disable OpenTelemetry console monitoring for Codex usage tracking
4
- argument-hint: "[enable|disable|status]"
5
- ---
6
-
7
- # Monitoring Setup Skill
8
-
9
- Enable or disable OpenTelemetry console monitoring. When enabled, Codex outputs usage metrics (cost, tokens, sessions, LOC, commits, PRs, active time) and events (tool results, API requests) to the terminal.
10
-
11
- ## Natural Language Triggers
12
-
13
- This skill activates when the user mentions any of:
14
- - Korean: "모니터링", "텔레메트리", "사용량 추적", "메트릭", "모니터링 켜줘", "텔레메트리 활성화"
15
- - English: "monitoring", "telemetry", "usage tracking", "metrics", "enable monitoring"
16
- - Combined with actions: "켜", "끄", "활성화", "비활성화", "설정", "enable", "disable", "setup"
17
-
18
- ## Commands
19
-
20
- ### enable (default)
21
-
22
- 1. Read `.codex/settings.local.json` (create if not exists)
23
- 2. Add or update `env` field with:
24
- ```json
25
- {
26
- "env": {
27
- "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
28
- "OTEL_METRICS_EXPORTER": "console",
29
- "OTEL_LOGS_EXPORTER": "console"
30
- }
31
- }
32
- ```
33
- 3. Preserve all existing settings
34
- 4. Report to user:
35
- ```
36
- [Done] OpenTelemetry Console Monitoring enabled
37
-
38
- Configured in: .codex/settings.local.json
39
- Metrics: sessions, cost, tokens, LOC, commits, PRs, active time
40
- Events: tool results, API requests, tool decisions
41
-
42
- Note: Takes effect on next `claude` session restart.
43
- To disable: /monitoring-setup disable
44
- ```
45
-
46
- ### disable
47
-
48
- 1. Read `.codex/settings.local.json`
49
- 2. Remove OTel-related keys from `env`:
50
- - `CLAUDE_CODE_ENABLE_TELEMETRY`
51
- - `OTEL_METRICS_EXPORTER`
52
- - `OTEL_LOGS_EXPORTER`
53
- 3. If `env` object becomes empty, remove `env` field entirely
54
- 4. Report:
55
- ```
56
- [Done] OpenTelemetry Monitoring disabled
57
-
58
- Removed from: .codex/settings.local.json
59
- Takes effect on next session restart.
60
- ```
61
-
62
- ### status
63
-
64
- 1. Read `.codex/settings.local.json`
65
- 2. Check for OTel env vars
66
- 3. Report current state:
67
- ```
68
- [Monitoring Status]
69
- ├── Enabled: Yes/No
70
- ├── Metrics exporter: console / otlp / none
71
- ├── Logs exporter: console / otlp / none
72
- └── Config: .codex/settings.local.json
73
- ```
74
-
75
- ## Implementation Notes
76
-
77
- - `settings.local.json` is NOT git-tracked (local to user)
78
- - Each user enables monitoring independently
79
- - No infrastructure required for console mode
80
- - Metrics appear in stderr during Codex execution
81
- - Default export interval: 60s for metrics, 5s for events
82
-
83
- ## Available Metrics
84
-
85
- | Metric | Description | Unit |
86
- |--------|-------------|------|
87
- | `claude_code.session.count` | CLI sessions started | count |
88
- | `claude_code.cost.usage` | Session cost | USD |
89
- | `claude_code.token.usage` | Tokens used (input/output/cache) | tokens |
90
- | `claude_code.lines_of_code.count` | Code lines modified (added/removed) | count |
91
- | `claude_code.commit.count` | Git commits created | count |
92
- | `claude_code.pull_request.count` | Pull requests created | count |
93
- | `claude_code.active_time.total` | Active usage time | seconds |
94
-
95
- ## Available Events
96
-
97
- | Event | Description |
98
- |-------|-------------|
99
- | `claude_code.tool_result` | Tool execution results with duration |
100
- | `claude_code.api_request` | API request details with cost/tokens |
101
- | `claude_code.api_error` | API error details |
102
- | `claude_code.tool_decision` | Tool accept/reject decisions |
103
- | `claude_code.user_prompt` | User prompt metadata (content redacted by default) |
104
-
105
- ## Upgrade Path
106
-
107
- For production monitoring, upgrade from console to OTLP:
108
-
109
- ```bash
110
- # In settings.local.json env:
111
- OTEL_METRICS_EXPORTER=otlp
112
- OTEL_LOGS_EXPORTER=otlp
113
- OTEL_EXPORTER_OTLP_PROTOCOL=grpc
114
- OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
115
- ```