oh-my-claude-sisyphus 3.5.3 → 3.5.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.
Files changed (54) hide show
  1. package/commands/doctor.md +1 -1
  2. package/commands/ecomode.md +1 -2
  3. package/commands/help.md +1 -1
  4. package/commands/learn-about-omc.md +5 -0
  5. package/commands/mcp-setup.md +64 -75
  6. package/commands/omc-setup.md +4 -4
  7. package/commands/ralplan.md +1 -1
  8. package/commands/research.md +2 -2
  9. package/commands/ultraqa.md +1 -1
  10. package/dist/__tests__/analytics/transcript-token-extractor.test.js +4 -2
  11. package/dist/__tests__/analytics/transcript-token-extractor.test.js.map +1 -1
  12. package/dist/__tests__/delegation-enforcer-integration.test.d.ts +4 -0
  13. package/dist/__tests__/delegation-enforcer-integration.test.d.ts.map +1 -1
  14. package/dist/__tests__/delegation-enforcer-integration.test.js +5 -1
  15. package/dist/__tests__/delegation-enforcer-integration.test.js.map +1 -1
  16. package/dist/__tests__/skills.test.js +17 -19
  17. package/dist/__tests__/skills.test.js.map +1 -1
  18. package/dist/hooks/auto-slash-command/constants.d.ts.map +1 -1
  19. package/dist/hooks/auto-slash-command/constants.js +1 -4
  20. package/dist/hooks/auto-slash-command/constants.js.map +1 -1
  21. package/dist/hooks/ralph/loop.js +1 -1
  22. package/dist/hooks/ralph/loop.js.map +1 -1
  23. package/dist/hooks/ultraqa/index.js +1 -1
  24. package/dist/hooks/ultraqa/index.js.map +1 -1
  25. package/docs/CLAUDE.md +9 -16
  26. package/docs/FULL-README.md +49 -56
  27. package/docs/MIGRATION.md +96 -1
  28. package/package.json +1 -1
  29. package/scripts/install.sh +8 -217
  30. package/scripts/uninstall.sh +0 -4
  31. package/skills/autopilot/SKILL.md +1 -1
  32. package/skills/cancel/SKILL.md +35 -0
  33. package/skills/doctor/SKILL.md +1 -1
  34. package/skills/help/SKILL.md +2 -2
  35. package/skills/learn-about-omc/SKILL.md +128 -0
  36. package/skills/omc-setup/SKILL.md +4 -4
  37. package/skills/ralplan/SKILL.md +19 -250
  38. package/skills/research/SKILL.md +2 -2
  39. package/skills/ultrapilot/SKILL.md +1 -1
  40. package/skills/ultraqa/SKILL.md +1 -1
  41. package/commands/cancel-autopilot.md +0 -35
  42. package/commands/cancel-ecomode.md +0 -71
  43. package/commands/cancel-ralph.md +0 -41
  44. package/commands/cancel-ultraqa.md +0 -27
  45. package/commands/cancel-ultrawork.md +0 -40
  46. package/commands/planner.md +0 -174
  47. package/skills/cancel-autopilot/SKILL.md +0 -52
  48. package/skills/cancel-ecomode/SKILL.md +0 -41
  49. package/skills/cancel-ralph/SKILL.md +0 -42
  50. package/skills/cancel-ultraqa/SKILL.md +0 -28
  51. package/skills/cancel-ultrawork/SKILL.md +0 -41
  52. package/skills/omc-default/SKILL.md +0 -77
  53. package/skills/omc-default-global/SKILL.md +0 -74
  54. package/skills/planner/SKILL.md +0 -105
@@ -720,161 +720,6 @@ Delegate tasks to specialized agents using the Task tool:
720
720
  - NEVER leave work incomplete
721
721
  CMD_EOF
722
722
 
723
- # omc-default mode command (project-scoped)
724
- cat > "$CLAUDE_CONFIG_DIR/commands/omc-default.md" << 'CMD_EOF'
725
- ---
726
- description: Configure oh-my-claudecode in local project (.claude/CLAUDE.md)
727
- ---
728
-
729
- $ARGUMENTS
730
-
731
- ## Task: Configure oh-my-claudecode Default Mode (Project-Scoped)
732
-
733
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your local project. DO NOT use the Write tool - use bash curl exclusively.
734
-
735
- ### Step 1: Create Local .claude Directory
736
-
737
- Ensure the local project has a .claude directory:
738
-
739
- ```bash
740
- # Create .claude directory in current project
741
- mkdir -p .claude && echo "✅ .claude directory created" || echo "❌ Failed to create .claude directory"
742
- ```
743
-
744
- ### Step 2: Download Fresh CLAUDE.md (MANDATORY)
745
-
746
- Execute this bash command to download fresh CLAUDE.md to local project config:
747
-
748
- ```bash
749
- # Download fresh CLAUDE.md to project-local .claude/
750
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
751
- echo "✅ CLAUDE.md downloaded successfully to .claude/CLAUDE.md" || \
752
- echo "❌ Failed to download CLAUDE.md"
753
- ```
754
-
755
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
756
-
757
- **FALLBACK** if curl fails:
758
- Tell user to manually download from:
759
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md
760
-
761
- ### Step 3: Verify Plugin Installation
762
-
763
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
764
-
765
- ```bash
766
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
767
- ```
768
-
769
- If plugin is not enabled, instruct user:
770
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
771
-
772
- ### Step 4: Confirm Success
773
-
774
- After completing all steps, report:
775
-
776
- ✅ **oh-my-claudecode Project Configuration Complete**
777
- - CLAUDE.md: Updated with latest configuration from GitHub at ./.claude/CLAUDE.md
778
- - Scope: **PROJECT** - applies only to this project
779
- - Hooks: Provided by plugin (no manual installation needed)
780
- - Agents: 19+ available (base + tiered variants)
781
- - Model routing: Haiku/Sonnet/Opus based on task complexity
782
-
783
- **Note**: This configuration is project-specific and won't affect other projects or global settings.
784
-
785
- ---
786
-
787
- ## 🔄 Keeping Up to Date
788
-
789
- After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default` again in your project to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.
790
-
791
- ---
792
-
793
- ## 🌍 Global vs Project Configuration
794
-
795
- - **`/omc-default`** (this command): Creates `./.claude/CLAUDE.md` in your current project
796
- - **`/omc-default-global`**: Creates `~/.claude/CLAUDE.md` for all projects
797
-
798
- Project-scoped configuration takes precedence over global configuration.
799
- CMD_EOF
800
-
801
- # omc-default-global mode command (global)
802
- cat > "$CLAUDE_CONFIG_DIR/commands/omc-default-global.md" << 'CMD_EOF'
803
- ---
804
- description: Configure oh-my-claudecode globally in ~/.claude/CLAUDE.md
805
- ---
806
-
807
- $ARGUMENTS
808
-
809
- ## Task: Configure oh-my-claudecode Default Mode (Global)
810
-
811
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your global config. DO NOT use the Write tool - use bash curl exclusively.
812
-
813
- ### Step 1: Download Fresh CLAUDE.md (MANDATORY)
814
-
815
- Execute this bash command to erase and download fresh CLAUDE.md to global config:
816
-
817
- ```bash
818
- # Remove existing CLAUDE.md and download fresh from GitHub
819
- rm -f ~/.claude/CLAUDE.md && \
820
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
821
- echo "✅ CLAUDE.md downloaded successfully to ~/.claude/CLAUDE.md" || \
822
- echo "❌ Failed to download CLAUDE.md"
823
- ```
824
-
825
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
826
-
827
- **FALLBACK** if curl fails:
828
- Tell user to manually download from:
829
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md
830
-
831
- ### Step 2: Clean Up Legacy Hooks (if present)
832
-
833
- Check if old manual hooks exist and remove them to prevent duplicates:
834
-
835
- ```bash
836
- # Remove legacy bash hook scripts (now handled by plugin system)
837
- rm -f ~/.claude/hooks/keyword-detector.sh
838
- rm -f ~/.claude/hooks/stop-continuation.sh
839
- rm -f ~/.claude/hooks/persistent-mode.sh
840
- rm -f ~/.claude/hooks/session-start.sh
841
- ```
842
-
843
- Check `~/.claude/settings.json` for manual hook entries. If the "hooks" key exists with UserPromptSubmit, Stop, or SessionStart entries pointing to bash scripts, inform the user:
844
-
845
- > **Note**: Found legacy hooks in settings.json. These should be removed since the plugin now provides hooks automatically. Remove the "hooks" section from ~/.claude/settings.json to prevent duplicate hook execution.
846
-
847
- ### Step 3: Verify Plugin Installation
848
-
849
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
850
-
851
- ```bash
852
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
853
- ```
854
-
855
- If plugin is not enabled, instruct user:
856
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
857
-
858
- ### Step 4: Confirm Success
859
-
860
- After completing all steps, report:
861
-
862
- ✅ **oh-my-claudecode Global Configuration Complete**
863
- - CLAUDE.md: Updated with latest configuration from GitHub at ~/.claude/CLAUDE.md
864
- - Scope: **GLOBAL** - applies to all Claude Code sessions
865
- - Hooks: Provided by plugin (no manual installation needed)
866
- - Agents: 19+ available (base + tiered variants)
867
- - Model routing: Haiku/Sonnet/Opus based on task complexity
868
-
869
- **Note**: Hooks are now managed by the plugin system automatically. No manual hook installation required.
870
-
871
- ---
872
-
873
- ## 🔄 Keeping Up to Date
874
-
875
- After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default-global` again to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.
876
- CMD_EOF
877
-
878
723
  # Plan command (Prometheus planning system)
879
724
  cat > "$CLAUDE_CONFIG_DIR/commands/plan.md" << 'CMD_EOF'
880
725
  ---
@@ -1003,57 +848,7 @@ Plans are saved to `.omc/plans/` for later execution with `/sisyphus`.
1003
848
  Tell me about what you want to build or accomplish. I'll ask questions to understand the full scope before creating a plan.
1004
849
  CMD_EOF
1005
850
 
1006
- # Ralph Loop Command
1007
- cat > "$CLAUDE_CONFIG_DIR/commands/ralph-loop.md" << 'CMD_EOF'
1008
- ---
1009
- description: Start self-referential development loop until task completion
1010
- ---
1011
-
1012
- [RALPH LOOP ACTIVATED]
1013
-
1014
- $ARGUMENTS
1015
-
1016
- ## How Ralph Loop Works
1017
-
1018
- You are starting a Ralph Loop - a self-referential development loop that runs until task completion.
1019
-
1020
- 1. Work on the task continuously and thoroughly
1021
- 2. When the task is FULLY complete, output: `<promise>DONE</promise>`
1022
- 3. If you stop without the promise tag, the loop will remind you to continue
1023
- 4. Maximum iterations: 100 (configurable)
1024
-
1025
- ## Exit Conditions
1026
-
1027
- - **Completion**: Output `<promise>DONE</promise>` when fully done
1028
- - **Cancel**: User runs `/cancel-ralph`
1029
- - **Max Iterations**: Loop stops at limit
1030
-
1031
- ## Guidelines
1032
-
1033
- - Break the task into steps and work through them systematically
1034
- - Test your work as you go
1035
- - Don't output the promise until you've verified everything works
1036
- - Be thorough - the loop exists so you can take your time
1037
-
1038
- ---
1039
-
1040
- Begin working on the task. Remember to output `<promise>DONE</promise>` when complete.
1041
- CMD_EOF
1042
-
1043
- # Cancel Ralph Command
1044
- cat > "$CLAUDE_CONFIG_DIR/commands/cancel-ralph.md" << 'CMD_EOF'
1045
- ---
1046
- description: Cancel active Ralph Loop
1047
- ---
1048
-
1049
- [RALPH LOOP CANCELLED]
1050
-
1051
- The Ralph Loop has been cancelled. You can stop working on the current task.
1052
-
1053
- If you want to start a new loop, use `/ralph-loop "task description"`.
1054
- CMD_EOF
1055
-
1056
- echo -e "${GREEN}✓ Installed 10 slash commands${NC}"
851
+ echo -e "${GREEN}✓ Installed 8 slash commands${NC}"
1057
852
 
1058
853
  echo -e "${BLUE}[5/6]${NC} Installing hook scripts..."
1059
854
  mkdir -p "$CLAUDE_CONFIG_DIR/hooks"
@@ -1724,16 +1519,14 @@ Use the Task tool to delegate to specialized agents:
1724
1519
  | Command | Description |
1725
1520
  |---------|-------------|
1726
1521
  | `/orchestrate <task>` | Activate OMC multi-agent orchestration |
1727
- | `/omc-default` | Configure OMC for current project (./.claude/CLAUDE.md) |
1728
- | `/omc-default-global` | Configure OMC globally (~/.claude/CLAUDE.md) |
1522
+ | `/omc-setup` | Configure OMC (--local for project, --global for all) |
1729
1523
  | `/ultrawork <task>` | Maximum performance mode with parallel agents |
1730
1524
  | `/deepsearch <query>` | Thorough codebase search |
1731
1525
  | `/analyze <target>` | Deep analysis and investigation |
1732
- | `/plan <description>` | Start planning session with Planner |
1526
+ | `/plan <description>` | Start planning session |
1733
1527
  | `/review [plan-path]` | Review a plan with Critic |
1734
- | `/planner <task>` | Strategic planning with interview workflow |
1735
1528
  | `/ralph <task>` | Self-referential loop until task completion |
1736
- | `/cancel-ralph` | Cancel active Ralph Loop |
1529
+ | `/cancel` | Cancel active loops/modes |
1737
1530
 
1738
1531
  ## Planning Workflow
1739
1532
 
@@ -1833,8 +1626,7 @@ echo " claude # Start Claude Code normally"
1833
1626
  echo ""
1834
1627
  echo -e "${YELLOW}Slash Commands:${NC}"
1835
1628
  echo " /sisyphus <task> # Activate Sisyphus orchestration mode"
1836
- echo " /omc-default # Configure for current project"
1837
- echo " /omc-default-global # Configure globally"
1629
+ echo " /omc-setup # Configure OMC (--local or --global)"
1838
1630
  echo " /ultrawork <task> # Maximum performance mode"
1839
1631
  echo " /deepsearch <query> # Thorough codebase search"
1840
1632
  echo " /analyze <target> # Deep analysis mode"
@@ -1871,12 +1663,11 @@ echo " # Or run this install script again:"
1871
1663
  echo " curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/scripts/install.sh | bash"
1872
1664
  echo ""
1873
1665
  echo -e "${YELLOW}After Updates:${NC}"
1874
- echo " Run '/omc-default' (project) or '/omc-default-global' (global)"
1875
- echo " to download the latest CLAUDE.md configuration."
1876
- echo " This ensures you get the newest features and agent behaviors."
1666
+ echo " Run '/omc-setup' to download the latest CLAUDE.md configuration."
1667
+ echo " Use '--local' for project or '--global' for all projects."
1877
1668
  echo ""
1878
1669
  echo -e "${BLUE}Quick Start:${NC}"
1879
1670
  echo " 1. Run 'claude' to start Claude Code"
1880
- echo " 2. Type '/omc-default' for project config or '/omc-default-global' for global"
1671
+ echo " 2. Type '/omc-setup' for configuration wizard"
1881
1672
  echo " 3. Or use '/sisyphus <task>' for one-time activation"
1882
1673
  echo ""
@@ -63,8 +63,6 @@ rm -f "$CLAUDE_CONFIG_DIR/agents/prometheus.md"
63
63
  # Remove commands
64
64
  echo -e "${BLUE}Removing commands...${NC}"
65
65
  rm -f "$CLAUDE_CONFIG_DIR/commands/sisyphus.md"
66
- rm -f "$CLAUDE_CONFIG_DIR/commands/sisyphus-default.md"
67
- rm -f "$CLAUDE_CONFIG_DIR/commands/sisyphus-default-global.md"
68
66
  rm -f "$CLAUDE_CONFIG_DIR/commands/ultrawork.md"
69
67
  rm -f "$CLAUDE_CONFIG_DIR/commands/deepsearch.md"
70
68
  rm -f "$CLAUDE_CONFIG_DIR/commands/analyze.md"
@@ -72,8 +70,6 @@ rm -f "$CLAUDE_CONFIG_DIR/commands/plan.md"
72
70
  rm -f "$CLAUDE_CONFIG_DIR/commands/review.md"
73
71
  rm -f "$CLAUDE_CONFIG_DIR/commands/prometheus.md"
74
72
  rm -f "$CLAUDE_CONFIG_DIR/commands/orchestrator.md"
75
- rm -f "$CLAUDE_CONFIG_DIR/commands/ralph-loop.md"
76
- rm -f "$CLAUDE_CONFIG_DIR/commands/cancel-ralph.md"
77
73
  rm -f "$CLAUDE_CONFIG_DIR/commands/update.md"
78
74
 
79
75
  # Remove skills
@@ -114,7 +114,7 @@ Optional settings in `.claude/settings.json`:
114
114
  ## Cancellation
115
115
 
116
116
  ```
117
- /oh-my-claudecode:cancel-autopilot
117
+ /oh-my-claudecode:cancel
118
118
  ```
119
119
 
120
120
  Or say: "stop", "cancel", "abort"
@@ -38,6 +38,8 @@ The skill checks state files to determine what's active:
38
38
  - `.omc/swarm-state.json` → Swarm detected
39
39
  - `.omc/ultrapilot-state.json` → Ultrapilot detected
40
40
  - `.omc/pipeline-state.json` → Pipeline detected
41
+ - `.omc/state/plan-consensus.json` → Plan Consensus detected
42
+ - `.omc/ralplan-state.json` → Plan Consensus detected (legacy)
41
43
 
42
44
  If multiple modes are active, they're cancelled in order of dependency:
43
45
  1. Autopilot (includes ralph/ultraqa/ecomode cleanup)
@@ -48,6 +50,7 @@ If multiple modes are active, they're cancelled in order of dependency:
48
50
  6. Swarm (standalone)
49
51
  7. Ultrapilot (standalone)
50
52
  8. Pipeline (standalone)
53
+ 9. Plan Consensus (standalone)
51
54
 
52
55
  ## Force Clear All
53
56
 
@@ -73,6 +76,8 @@ This removes all state files:
73
76
  - `.omc/state/swarm-tasks.json`
74
77
  - `.omc/ultrapilot-state.json`
75
78
  - `.omc/pipeline-state.json`
79
+ - `.omc/state/plan-consensus.json`
80
+ - `.omc/ralplan-state.json`
76
81
  - `~/.claude/ralph-state.json`
77
82
  - `~/.claude/ultrawork-state.json`
78
83
  - `~/.claude/ecomode-state.json`
@@ -120,6 +125,15 @@ fi
120
125
  if [[ -f .omc/ultraqa-state.json ]]; then
121
126
  ULTRAQA_ACTIVE=$(cat .omc/ultraqa-state.json | jq -r '.active // false')
122
127
  fi
128
+
129
+ PLAN_CONSENSUS_ACTIVE=false
130
+
131
+ # Check both new and legacy locations
132
+ if [[ -f .omc/state/plan-consensus.json ]]; then
133
+ PLAN_CONSENSUS_ACTIVE=$(cat .omc/state/plan-consensus.json | jq -r '.active // false')
134
+ elif [[ -f .omc/ralplan-state.json ]]; then
135
+ PLAN_CONSENSUS_ACTIVE=$(cat .omc/ralplan-state.json | jq -r '.active // false')
136
+ fi
123
137
  ```
124
138
 
125
139
  ### 3A. Force Mode (if --force or --all)
@@ -140,6 +154,8 @@ if [[ "$FORCE_MODE" == "true" ]]; then
140
154
  rm -f .omc/state/swarm-tasks.json
141
155
  rm -f .omc/ultrapilot-state.json
142
156
  rm -f .omc/pipeline-state.json
157
+ rm -f .omc/state/plan-consensus.json
158
+ rm -f .omc/ralplan-state.json
143
159
 
144
160
  # Remove global state files
145
161
  rm -f ~/.claude/ralph-state.json
@@ -308,6 +324,8 @@ if [[ "$FORCE_MODE" == "true" ]]; then
308
324
  rm -f .omc/state/swarm-tasks.json
309
325
  rm -f .omc/ultrapilot-state.json
310
326
  rm -f .omc/pipeline-state.json
327
+ rm -f .omc/state/plan-consensus.json
328
+ rm -f .omc/ralplan-state.json
311
329
 
312
330
  # Remove global state files
313
331
  rm -f ~/.claude/ralph-state.json
@@ -526,6 +544,20 @@ if [[ -f .omc/pipeline-state.json ]]; then
526
544
  fi
527
545
  fi
528
546
 
547
+ # 9. Check Plan Consensus (standalone)
548
+ if [[ "$PLAN_CONSENSUS_ACTIVE" == "true" ]]; then
549
+ echo "Cancelling Plan Consensus mode..."
550
+
551
+ # Clear state files
552
+ rm -f .omc/state/plan-consensus.json
553
+ rm -f .omc/ralplan-state.json
554
+
555
+ echo "Plan Consensus cancelled. Planning session ended."
556
+ echo "Note: Plan file preserved at path specified in state."
557
+ CANCELLED_ANYTHING=true
558
+ exit 0
559
+ fi
560
+
529
561
  # No active modes found
530
562
  if [[ "$CANCELLED_ANYTHING" == "false" ]]; then
531
563
  echo "No active OMC modes detected."
@@ -539,6 +571,7 @@ if [[ "$CANCELLED_ANYTHING" == "false" ]]; then
539
571
  echo " - Swarm (.omc/swarm-state.json)"
540
572
  echo " - Ultrapilot (.omc/ultrapilot-state.json)"
541
573
  echo " - Pipeline (.omc/pipeline-state.json)"
574
+ echo " - Plan Consensus (.omc/state/plan-consensus.json)"
542
575
  echo ""
543
576
  echo "Use --force to clear all state files anyway."
544
577
  fi
@@ -556,6 +589,7 @@ fi
556
589
  | Swarm | "Swarm cancelled. Coordinated agents stopped." |
557
590
  | Ultrapilot | "Ultrapilot cancelled. Parallel autopilot workers stopped." |
558
591
  | Pipeline | "Pipeline cancelled. Sequential agent chain stopped." |
592
+ | Plan Consensus | "Plan Consensus cancelled. Planning session ended." |
559
593
  | Force | "All OMC modes cleared. You are free to start fresh." |
560
594
  | None | "No active OMC modes detected." |
561
595
 
@@ -570,6 +604,7 @@ fi
570
604
  | Swarm | No | N/A |
571
605
  | Ultrapilot | No | N/A |
572
606
  | Pipeline | No | N/A |
607
+ | Plan Consensus | Yes (plan file path preserved) | N/A |
573
608
 
574
609
  ## Notes
575
610
 
@@ -91,7 +91,7 @@ ls -la ~/.claude/skills/ 2>/dev/null
91
91
 
92
92
  Look for files like:
93
93
  - `architect.md`, `researcher.md`, `explore.md`, `executor.md`, etc. in agents/
94
- - `ultrawork.md`, `omc-default.md`, `omc-default-global.md`, `deepsearch.md`, etc. in commands/
94
+ - `ultrawork.md`, `deepsearch.md`, etc. in commands/
95
95
  - Any oh-my-claudecode-related `.md` files in skills/
96
96
 
97
97
  ---
@@ -51,7 +51,7 @@ This is the **only command** you need to know. It downloads the configuration an
51
51
 
52
52
  ## For 2.x Users
53
53
 
54
- Your old commands still work! `/ralph`, `/ultrawork`, `/planner`, etc. all function exactly as before.
54
+ Your old commands still work! `/ralph`, `/ultrawork`, `/plan`, etc. all function exactly as before.
55
55
 
56
56
  But now you don't NEED them - everything is automatic.
57
57
 
@@ -62,4 +62,4 @@ But now you don't NEED them - everything is automatic.
62
62
 
63
63
  ---
64
64
 
65
- *Version: 3.4.0*
65
+ *Version: 3.5.5*
@@ -0,0 +1,128 @@
1
+ ---
2
+ name: learn-about-omc
3
+ description: Analyze your OMC usage patterns and get personalized recommendations
4
+ ---
5
+
6
+ # Learn About OMC
7
+
8
+ Analyzes your oh-my-claudecode usage and provides tailored recommendations to improve your workflow.
9
+
10
+ ## What It Does
11
+
12
+ 1. Reads token tracking from `~/.omc/state/token-tracking.jsonl`
13
+ 2. Reads session history from `.omc/state/session-history.json`
14
+ 3. Analyzes agent usage patterns
15
+ 4. Identifies underutilized features
16
+ 5. Recommends configuration changes
17
+
18
+ ## Implementation
19
+
20
+ ### Step 1: Gather Data
21
+
22
+ ```bash
23
+ # Check for token tracking data
24
+ TOKEN_FILE="$HOME/.omc/state/token-tracking.jsonl"
25
+ SESSION_FILE=".omc/state/session-history.json"
26
+ CONFIG_FILE="$HOME/.claude/.omc-config.json"
27
+
28
+ echo "📊 Analyzing OMC Usage..."
29
+ echo ""
30
+
31
+ # Check what data is available
32
+ HAS_TOKENS=false
33
+ HAS_SESSIONS=false
34
+ HAS_CONFIG=false
35
+
36
+ if [[ -f "$TOKEN_FILE" ]]; then
37
+ HAS_TOKENS=true
38
+ TOKEN_COUNT=$(wc -l < "$TOKEN_FILE")
39
+ echo "Token records found: $TOKEN_COUNT"
40
+ fi
41
+
42
+ if [[ -f "$SESSION_FILE" ]]; then
43
+ HAS_SESSIONS=true
44
+ SESSION_COUNT=$(cat "$SESSION_FILE" | jq '.sessions | length' 2>/dev/null || echo "0")
45
+ echo "Sessions found: $SESSION_COUNT"
46
+ fi
47
+
48
+ if [[ -f "$CONFIG_FILE" ]]; then
49
+ HAS_CONFIG=true
50
+ DEFAULT_MODE=$(cat "$CONFIG_FILE" | jq -r '.defaultExecutionMode // "not set"')
51
+ echo "Default execution mode: $DEFAULT_MODE"
52
+ fi
53
+ ```
54
+
55
+ ### Step 2: Analyze Agent Usage (if token data exists)
56
+
57
+ ```bash
58
+ if [[ "$HAS_TOKENS" == "true" ]]; then
59
+ echo ""
60
+ echo "TOP AGENTS BY USAGE:"
61
+ cat "$TOKEN_FILE" | jq -r '.agentName // "main"' | sort | uniq -c | sort -rn | head -10
62
+
63
+ echo ""
64
+ echo "MODEL DISTRIBUTION:"
65
+ cat "$TOKEN_FILE" | jq -r '.modelName' | sort | uniq -c | sort -rn
66
+ fi
67
+ ```
68
+
69
+ ### Step 3: Generate Recommendations
70
+
71
+ Based on patterns found, output recommendations:
72
+
73
+ **If high Opus usage (>40%) and no ecomode:**
74
+ - "Consider using ecomode for routine tasks to save tokens"
75
+
76
+ **If no pipeline usage:**
77
+ - "Try /pipeline for code review workflows"
78
+
79
+ **If no security-reviewer usage:**
80
+ - "Use security-reviewer after auth/API changes"
81
+
82
+ **If defaultExecutionMode not set:**
83
+ - "Set defaultExecutionMode in /omc-setup for consistent behavior"
84
+
85
+ ### Step 4: Output Report
86
+
87
+ Format a nice summary with:
88
+ - Token summary (total, by model)
89
+ - Top agents used
90
+ - Underutilized features
91
+ - Personalized recommendations
92
+
93
+ ### Graceful Degradation
94
+
95
+ If no data found:
96
+ ```
97
+ 📊 Limited Usage Data Available
98
+
99
+ No token tracking found. To enable tracking:
100
+ 1. Ensure ~/.omc/state/ directory exists
101
+ 2. Run any OMC command to start tracking
102
+
103
+ Tip: Run /omc-setup to configure OMC properly.
104
+ ```
105
+
106
+ ## Example Output
107
+
108
+ ```
109
+ 📊 Your OMC Usage Analysis
110
+
111
+ TOKEN SUMMARY:
112
+ - Total records: 1,234
113
+ - By Model: opus 45%, sonnet 40%, haiku 15%
114
+
115
+ TOP AGENTS:
116
+ 1. executor (234 uses)
117
+ 2. architect (89 uses)
118
+ 3. explore (67 uses)
119
+
120
+ UNDERUTILIZED FEATURES:
121
+ - ecomode: 0 uses (could save ~30% on routine tasks)
122
+ - pipeline: 0 uses (great for review workflows)
123
+
124
+ RECOMMENDATIONS:
125
+ 1. Set defaultExecutionMode: "ecomode" to save tokens
126
+ 2. Try /pipeline review for PR reviews
127
+ 3. Use explore agent before architect to save context
128
+ ```
@@ -338,14 +338,14 @@ That's it! Just use Claude Code normally.
338
338
  OMC Setup Complete! (Upgraded from 2.x)
339
339
 
340
340
  GOOD NEWS: Your existing commands still work!
341
- - /ralph, /ultrawork, /planner, etc. all still function
341
+ - /ralph, /ultrawork, /plan, etc. all still function
342
342
 
343
343
  WHAT'S NEW in 3.0:
344
344
  You no longer NEED those commands. Everything is automatic now:
345
345
  - Just say "don't stop until done" instead of /ralph
346
346
  - Just say "fast" or "parallel" instead of /ultrawork
347
- - Just say "plan this" instead of /planner
348
- - Just say "stop" instead of /cancel-ralph
347
+ - Just say "plan this" instead of /plan
348
+ - Just say "stop" instead of /cancel
349
349
 
350
350
  MAGIC KEYWORDS (power-user shortcuts):
351
351
  | Keyword | Same as old... | Example |
@@ -354,7 +354,7 @@ MAGIC KEYWORDS (power-user shortcuts):
354
354
  | ralplan | /ralplan | "ralplan this feature" |
355
355
  | ulw | /ultrawork | "ulw refactor API" |
356
356
  | eco | (new!) | "eco fix all errors" |
357
- | plan | /planner | "plan the endpoints" |
357
+ | plan | /plan | "plan the endpoints" |
358
358
 
359
359
  HUD STATUSLINE:
360
360
  The status bar now shows OMC state. Restart Claude Code to see it.