@lgcyaxi/oh-my-claude 1.0.0 → 1.1.1

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 (49) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +43 -0
  2. package/CHANGELOG.md +53 -0
  3. package/CLAUDE.md +60 -0
  4. package/README.md +97 -12
  5. package/README.zh-CN.md +58 -11
  6. package/bin/oh-my-claude.js +4 -2
  7. package/changelog/v1.0.0.md +28 -0
  8. package/changelog/v1.0.1.md +28 -0
  9. package/changelog/v1.1.0.md +20 -0
  10. package/changelog/v1.1.1.md +71 -0
  11. package/dist/cli.js +213 -4
  12. package/dist/hooks/comment-checker.js +1 -1
  13. package/dist/hooks/task-notification.js +124 -0
  14. package/dist/hooks/task-tracker.js +144 -0
  15. package/dist/index-1dv6t98k.js +7654 -0
  16. package/dist/index-5ars1tn4.js +7348 -0
  17. package/dist/index-d79fk9ah.js +7350 -0
  18. package/dist/index-hzm01rkh.js +7654 -0
  19. package/dist/index-qrbfj4cd.js +7664 -0
  20. package/dist/index-ypyx3ye0.js +7349 -0
  21. package/dist/index.js +24 -1
  22. package/dist/mcp/server.js +202 -45
  23. package/dist/statusline/statusline.js +146 -0
  24. package/package.json +6 -5
  25. package/src/agents/document-writer.ts +5 -0
  26. package/src/agents/explore.ts +5 -0
  27. package/src/agents/frontend-ui-ux.ts +5 -0
  28. package/src/agents/librarian.ts +5 -0
  29. package/src/agents/oracle.ts +5 -0
  30. package/src/agents/types.ts +11 -0
  31. package/src/cli.ts +261 -2
  32. package/src/commands/index.ts +8 -1
  33. package/src/commands/omc-status.md +71 -0
  34. package/src/commands/omcx-issue.md +175 -0
  35. package/src/commands/ulw.md +144 -0
  36. package/src/config/loader.ts +73 -0
  37. package/src/config/schema.ts +25 -2
  38. package/src/generators/agent-generator.ts +17 -1
  39. package/src/hooks/comment-checker.ts +2 -2
  40. package/src/hooks/task-notification.ts +206 -0
  41. package/src/hooks/task-tracker.ts +252 -0
  42. package/src/installer/index.ts +55 -4
  43. package/src/installer/settings-merger.ts +86 -0
  44. package/src/installer/statusline-merger.ts +169 -0
  45. package/src/mcp/background-agent-server/server.ts +11 -2
  46. package/src/mcp/background-agent-server/task-manager.ts +83 -4
  47. package/src/providers/router.ts +28 -0
  48. package/src/statusline/formatter.ts +164 -0
  49. package/src/statusline/statusline.ts +103 -0
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: Bug Report
3
+ about: Report a bug in oh-my-claude
4
+ title: '[Bug] '
5
+ labels: bug
6
+ ---
7
+
8
+ ## Description
9
+ <!-- Brief summary of the issue -->
10
+
11
+ ## What happened
12
+ <!-- Describe the actual behavior -->
13
+
14
+ ## Expected behavior
15
+ <!-- What you expected to happen -->
16
+
17
+ ## Steps to reproduce
18
+ 1.
19
+ 2.
20
+ 3.
21
+
22
+ ## Environment
23
+ <!-- Run: oh-my-claude doctor (or npx @lgcyaxi/oh-my-claude doctor) -->
24
+
25
+ | Component | Value |
26
+ |-----------|-------|
27
+ | oh-my-claude version | |
28
+ | OS | |
29
+ | Node.js | |
30
+ | Bun | |
31
+ | Installation | global / npx |
32
+
33
+ <details>
34
+ <summary>Doctor output</summary>
35
+
36
+ ```
37
+ <!-- Paste doctor output here (remove any API keys) -->
38
+ ```
39
+
40
+ </details>
41
+
42
+ ## Additional context
43
+ <!-- Any other information that might help diagnose the issue -->
package/CHANGELOG.md ADDED
@@ -0,0 +1,53 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ Individual version changelogs are available in the [changelog/](./changelog/) directory.
9
+
10
+ ## [1.1.1] - 2026-01-16
11
+
12
+ See [changelog/v1.1.1.md](./changelog/v1.1.1.md) for details.
13
+
14
+ ### Added
15
+ - Real-time StatusLine showing active agents and provider availability
16
+ - Task tool agent tracking (Claude-Reviewer, Claude-Scout, etc.)
17
+ - StatusLine CLI subcommand (`statusline --enable/--disable/--status`)
18
+ - Multi-line statusline support (merges with existing statusline)
19
+
20
+ ### Changed
21
+ - MCP server now writes status file on startup
22
+ - Doctor command shows statusline status
23
+
24
+ ## [1.1.0] - 2026-01-15
25
+
26
+ See [changelog/v1.1.0.md](./changelog/v1.1.0.md) for details.
27
+
28
+ ### Added
29
+ - Bug reporting command (`/omcx-issue`)
30
+ - GitHub issue template for bug reports
31
+
32
+ ## [1.0.1] - 2025-01-15
33
+
34
+ See [changelog/v1.0.1.md](./changelog/v1.0.1.md) for details.
35
+
36
+ ### Added
37
+ - Self-update command (`update`)
38
+ - Automatic fallback to Claude models when API keys not configured
39
+
40
+ ### Fixed
41
+ - Windows ESM path compatibility
42
+
43
+ ## [1.0.0] - 2025-01-15
44
+
45
+ See [changelog/v1.0.0.md](./changelog/v1.0.0.md) for details.
46
+
47
+ ### Added
48
+ - Initial release
49
+ - Multi-provider MCP server (DeepSeek, ZhiPu GLM, MiniMax)
50
+ - Specialized agent workflows
51
+ - Slash commands and CLI tools
52
+ - Planning system with Prometheus
53
+ - Hook integration
package/CLAUDE.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # oh-my-claude Development Guide
2
2
 
3
+ ## Project Overview
4
+
5
+ Multi-provider MCP server for Claude Code with specialized agent workflows. Routes background tasks to DeepSeek, ZhiPu GLM, MiniMax via Anthropic-compatible APIs.
6
+
7
+ **npm package:** `@lgcyaxi/oh-my-claude`
8
+
3
9
  ## Build Commands
4
10
 
5
11
  ```bash
@@ -37,3 +43,57 @@ bun test # Run tests
37
43
  bun run install-local # Build and install to ~/.claude/
38
44
  oh-my-claude doctor # Verify configuration
39
45
  ```
46
+
47
+ ## Slash Commands
48
+
49
+ Commands are defined in `src/commands/`:
50
+
51
+ - **Agent Commands (`/omc-*`)**: Activate specific agents (sisyphus, oracle, librarian, etc.)
52
+ - **Action Commands (`/omcx-*`)**: Quick actions (commit, implement, refactor, docs)
53
+ - **Mode Commands**: `/ulw` (Ultrawork - maximum performance, work until done)
54
+
55
+ When adding new commands:
56
+ 1. Create `.md` file in `src/commands/`
57
+ 2. Add to appropriate array in `src/commands/index.ts`
58
+ 3. Update README documentation
59
+
60
+ ## Fallback System
61
+
62
+ MCP agents automatically fall back to Claude models when provider API keys are not configured:
63
+
64
+ - Oracle → claude-opus-4-5
65
+ - Librarian → claude-sonnet-4-5
66
+ - Explore → claude-haiku-4-5
67
+ - Frontend-UI-UX → claude-sonnet-4-5
68
+ - Document-Writer → claude-sonnet-4-5
69
+
70
+ Configuration in `src/config/schema.ts` with `fallback` field on agents.
71
+
72
+ ## Release Process
73
+
74
+ ```bash
75
+ # 1. Update version in package.json and src/cli.ts
76
+ # 2. Create changelog in changelog/vX.X.X.md
77
+ # 3. Update CHANGELOG.md
78
+ # 4. Commit to dev branch
79
+ # 5. Squash merge to main
80
+ git checkout main && git merge --squash dev
81
+ git commit -m "release: vX.X.X - description"
82
+ git tag vX.X.X
83
+ git push origin main --tags
84
+
85
+ # 6. Publish to npm
86
+ npm publish --access public
87
+ ```
88
+
89
+ ## Git Conventions
90
+
91
+ - `.sisyphus/` directory at project root should NOT be committed (session state files)
92
+ - Always check `git status` before committing to avoid staging unwanted files
93
+
94
+ ## Key Files
95
+
96
+ - `src/config/loader.ts` - Config loading with fallback helpers
97
+ - `src/providers/router.ts` - Routes requests to providers, handles FallbackRequiredError
98
+ - `src/mcp/background-agent-server/server.ts` - MCP server implementation
99
+ - `bin/oh-my-claude.js` - CLI entry point (uses pathToFileURL for Windows compatibility)
package/README.md CHANGED
@@ -11,10 +11,11 @@ Route background tasks to multiple AI providers (DeepSeek, ZhiPu GLM, MiniMax) v
11
11
  - **Multi-Provider MCP Server** - Background task execution with DeepSeek, ZhiPu GLM, MiniMax
12
12
  - **Specialized Agent Workflows** - Pre-configured agents for different task types (Sisyphus, Oracle, Librarian, etc.)
13
13
  - **Slash Commands** - Quick actions (`/omcx-commit`, `/omcx-implement`) and agent activation (`/omc-sisyphus`, `/omc-plan`)
14
+ - **Real-Time StatusLine** - Live status bar showing active agents, task progress, and provider availability
14
15
  - **Planning System** - Strategic planning with Prometheus agent and boulder-state tracking
15
16
  - **Official MCP Setup** - One-command installation for Sequential Thinking, MiniMax, and GLM MCPs
16
17
  - **Concurrent Execution** - Per-provider rate limiting and parallel task management
17
- - **Hook Integration** - Code quality checks and todo tracking
18
+ - **Hook Integration** - Code quality checks, todo tracking, and agent monitoring
18
19
 
19
20
  ## Quick Start
20
21
 
@@ -89,6 +90,7 @@ npx @lgcyaxi/oh-my-claude doctor --detail
89
90
  | `/omc-explore` | Activate Explore - codebase search |
90
91
  | `/omc-plan` | Start strategic planning with Prometheus |
91
92
  | `/omc-start-work` | Begin work on an existing plan |
93
+ | `/omc-status` | Display MCP background agent status dashboard |
92
94
 
93
95
  ### Quick Action Commands (`/omcx-*`)
94
96
 
@@ -98,20 +100,93 @@ npx @lgcyaxi/oh-my-claude doctor --detail
98
100
  | `/omcx-implement` | Implement a feature with best practices |
99
101
  | `/omcx-refactor` | Refactor code with quality improvements |
100
102
  | `/omcx-docs` | Generate or update documentation |
103
+ | `/omcx-issue` | Report a bug to oh-my-claude GitHub Issues |
104
+
105
+ ### Mode Commands
106
+
107
+ | Command | Description |
108
+ |---------|-------------|
109
+ | `/ulw` | **Ultrawork Mode** - Maximum performance, work until done |
110
+
111
+ #### Ultrawork Mode (`/ulw`)
112
+
113
+ Ultrawork mode activates **maximum performance execution** with zero-tolerance completion policy:
114
+
115
+ - **100% Delivery** - No partial completion, no scope reduction, no placeholders
116
+ - **Aggressive Parallelization** - Fire multiple agents simultaneously
117
+ - **Mandatory Verification** - Code compiles, tests pass, build succeeds
118
+ - **Work Until Done** - Continue until ALL tasks are marked complete
119
+
120
+ **Usage:**
121
+ ```bash
122
+ /ulw implement the authentication system from the plan
123
+ /ulw fix all type errors in the codebase
124
+ /ulw add comprehensive test coverage for the API
125
+ ```
126
+
127
+ **Key Features:**
128
+ - Automatically creates comprehensive todo lists
129
+ - Uses sync agents (Task tool) and async agents (MCP) in parallel
130
+ - Verifies each step before marking complete
131
+ - Boulder state persistence for session continuity
132
+
133
+ ## Real-Time StatusLine
134
+
135
+ oh-my-claude provides a real-time status bar that shows active agents and provider availability directly in Claude Code.
136
+
137
+ ### Status Display
138
+
139
+ ```
140
+ omc ready | DS: 10 ZP: 10 MM: 5 # Idle - showing available slots
141
+ omc [Oracle: 32s] [@Scout: 15s] | DS: 1/10 ... # Active tasks with elapsed time
142
+ ```
143
+
144
+ ### Legend
145
+
146
+ - **omc ready** - System is ready, no active tasks
147
+ - **[Oracle: 32s]** - MCP background agent running (via external API)
148
+ - **[@Scout: 15s]** - Task tool agent running (via Claude subscription)
149
+ - **DS: 1/10** - DeepSeek: 1 active / 10 max concurrent slots
150
+ - **ZP: 0/10** - ZhiPu: 0 active / 10 max concurrent
151
+ - **MM: 0/5** - MiniMax: 0 active / 5 max concurrent
152
+
153
+ ### CLI Control
154
+
155
+ ```bash
156
+ npx @lgcyaxi/oh-my-claude statusline --status # Check statusline status
157
+ npx @lgcyaxi/oh-my-claude statusline --enable # Enable statusline
158
+ npx @lgcyaxi/oh-my-claude statusline --disable # Disable statusline
159
+ ```
160
+
161
+ ### Multi-Line Support
162
+
163
+ When you have an existing statusline (like CCometixLine), oh-my-claude automatically creates a wrapper that shows both on separate lines.
101
164
 
102
165
  ## Agent Workflows
103
166
 
104
- | Agent | Provider | Model | Role |
105
- |-------|----------|-------|------|
106
- | **Sisyphus** | Claude (Task tool) | claude-opus-4-5 | Primary orchestrator |
107
- | **Claude-Reviewer** | Claude (Task tool) | claude-sonnet-4-5 | Code review, QA |
108
- | **Claude-Scout** | Claude (Task tool) | claude-haiku-4-5 | Fast exploration |
109
- | **Prometheus** | Claude (Task tool) | claude-opus-4-5 | Strategic planning |
110
- | **Oracle** | DeepSeek (MCP) | deepseek-reasoner | Deep reasoning |
111
- | **Librarian** | ZhiPu (MCP) | glm-4.7 | External research |
112
- | **Explore** | DeepSeek (MCP) | deepseek-chat | Codebase search |
113
- | **Frontend-UI-UX** | ZhiPu (MCP) | glm-4v-flash | Visual/UI design |
114
- | **Document-Writer** | MiniMax (MCP) | MiniMax-M2.1 | Documentation |
167
+ | Agent | Provider | Model | Role | Fallback |
168
+ |-------|----------|-------|------|----------|
169
+ | **Sisyphus** | Claude (Task tool) | claude-opus-4-5 | Primary orchestrator | - |
170
+ | **Claude-Reviewer** | Claude (Task tool) | claude-sonnet-4-5 | Code review, QA | - |
171
+ | **Claude-Scout** | Claude (Task tool) | claude-haiku-4-5 | Fast exploration | - |
172
+ | **Prometheus** | Claude (Task tool) | claude-opus-4-5 | Strategic planning | - |
173
+ | **Oracle** | DeepSeek (MCP) | deepseek-reasoner | Deep reasoning | claude-opus-4-5 |
174
+ | **Librarian** | ZhiPu (MCP) | glm-4.7 | External research | claude-sonnet-4-5 |
175
+ | **Explore** | DeepSeek (MCP) | deepseek-chat | Codebase search | claude-haiku-4-5 |
176
+ | **Frontend-UI-UX** | ZhiPu (MCP) | glm-4v-flash | Visual/UI design | claude-sonnet-4-5 |
177
+ | **Document-Writer** | MiniMax (MCP) | MiniMax-M2.1 | Documentation | claude-sonnet-4-5 |
178
+
179
+ ### Automatic Fallback
180
+
181
+ MCP agents automatically fall back to Claude models when the provider's API key is not configured:
182
+
183
+ - **Oracle** → `claude-opus-4-5` (preserves deep reasoning capability)
184
+ - **Librarian** → `claude-sonnet-4-5` (balanced research capability)
185
+ - **Explore** → `claude-haiku-4-5` (fast search operations)
186
+ - **Frontend-UI-UX** → `claude-sonnet-4-5` (quality visual design)
187
+ - **Document-Writer** → `claude-sonnet-4-5` (quality documentation)
188
+
189
+ This allows oh-my-claude to work with Claude Code's subscription even without external API keys.
115
190
 
116
191
  ## Official MCP Servers
117
192
 
@@ -134,6 +209,11 @@ npx @lgcyaxi/oh-my-claude install # Install oh-my-claude
134
209
  npx @lgcyaxi/oh-my-claude install --force # Force reinstall
135
210
  npx @lgcyaxi/oh-my-claude install --skip-mcp # Skip MCP server setup
136
211
 
212
+ # Update
213
+ npx @lgcyaxi/oh-my-claude update # Update to latest version
214
+ npx @lgcyaxi/oh-my-claude update --check # Check for updates only
215
+ npx @lgcyaxi/oh-my-claude update --force # Force reinstall latest
216
+
137
217
  # Status & Diagnostics
138
218
  npx @lgcyaxi/oh-my-claude status # Check installation status
139
219
  npx @lgcyaxi/oh-my-claude doctor # Diagnose configuration
@@ -150,6 +230,11 @@ npx @lgcyaxi/oh-my-claude setup-mcp --glm # GLM/ZhiPu servers only
150
230
  # Uninstall
151
231
  npx @lgcyaxi/oh-my-claude uninstall # Remove oh-my-claude
152
232
  npx @lgcyaxi/oh-my-claude uninstall --keep-config # Keep config file
233
+
234
+ # StatusLine
235
+ npx @lgcyaxi/oh-my-claude statusline --status # Check statusline status
236
+ npx @lgcyaxi/oh-my-claude statusline --enable # Enable statusline
237
+ npx @lgcyaxi/oh-my-claude statusline --disable # Disable statusline
153
238
  ```
154
239
 
155
240
  ## Configuration
package/README.zh-CN.md CHANGED
@@ -89,6 +89,7 @@ npx @lgcyaxi/oh-my-claude doctor --detail
89
89
  | `/omc-explore` | 激活 Explore - 代码库搜索 |
90
90
  | `/omc-plan` | 使用 Prometheus 开始战略规划 |
91
91
  | `/omc-start-work` | 开始执行现有计划 |
92
+ | `/omc-status` | 显示 MCP 后台智能体状态仪表板 |
92
93
 
93
94
  ### 快捷操作命令(`/omcx-*`)
94
95
 
@@ -98,20 +99,61 @@ npx @lgcyaxi/oh-my-claude doctor --detail
98
99
  | `/omcx-implement` | 按最佳实践实现功能 |
99
100
  | `/omcx-refactor` | 重构代码并提升质量 |
100
101
  | `/omcx-docs` | 生成或更新文档 |
102
+ | `/omcx-issue` | 向 oh-my-claude GitHub Issues 报告 Bug |
103
+
104
+ ### 模式命令
105
+
106
+ | 命令 | 描述 |
107
+ |------|------|
108
+ | `/ulw` | **超级工作模式** - 最高性能,工作到完成 |
109
+
110
+ #### 超级工作模式(`/ulw`)
111
+
112
+ 超级工作模式激活**最高性能执行**,采用零容忍完成策略:
113
+
114
+ - **100% 交付** - 不允许部分完成、不允许缩小范围、不允许占位符
115
+ - **激进并行化** - 同时启动多个智能体
116
+ - **强制验证** - 代码编译、测试通过、构建成功
117
+ - **工作到完成** - 持续执行直到所有任务标记完成
118
+
119
+ **使用方法:**
120
+ ```bash
121
+ /ulw 根据计划实现认证系统
122
+ /ulw 修复代码库中的所有类型错误
123
+ /ulw 为 API 添加全面的测试覆盖
124
+ ```
125
+
126
+ **核心特性:**
127
+ - 自动创建全面的待办列表
128
+ - 同步智能体(Task 工具)和异步智能体(MCP)并行使用
129
+ - 每个步骤验证后才标记完成
130
+ - 巨石状态持久化以支持会话延续
101
131
 
102
132
  ## 智能体工作流
103
133
 
104
- | 智能体 | 供应商 | 模型 | 角色 |
105
- |--------|--------|------|------|
106
- | **Sisyphus** | Claude(Task 工具)| claude-opus-4-5 | 主编排器 |
107
- | **Claude-Reviewer** | Claude(Task 工具)| claude-sonnet-4-5 | 代码审查、质量保证 |
108
- | **Claude-Scout** | Claude(Task 工具)| claude-haiku-4-5 | 快速探索 |
109
- | **Prometheus** | Claude(Task 工具)| claude-opus-4-5 | 战略规划 |
110
- | **Oracle** | DeepSeek(MCP)| deepseek-reasoner | 深度推理 |
111
- | **Librarian** | 智谱(MCP)| glm-4.7 | 外部研究 |
112
- | **Explore** | DeepSeek(MCP)| deepseek-chat | 代码库搜索 |
113
- | **Frontend-UI-UX** | 智谱(MCP)| glm-4v-flash | 视觉/UI 设计 |
114
- | **Document-Writer** | MiniMax(MCP)| MiniMax-M2.1 | 文档编写 |
134
+ | 智能体 | 供应商 | 模型 | 角色 | 降级模型 |
135
+ |--------|--------|------|------|----------|
136
+ | **Sisyphus** | Claude(Task 工具)| claude-opus-4-5 | 主编排器 | - |
137
+ | **Claude-Reviewer** | Claude(Task 工具)| claude-sonnet-4-5 | 代码审查、质量保证 | - |
138
+ | **Claude-Scout** | Claude(Task 工具)| claude-haiku-4-5 | 快速探索 | - |
139
+ | **Prometheus** | Claude(Task 工具)| claude-opus-4-5 | 战略规划 | - |
140
+ | **Oracle** | DeepSeek(MCP)| deepseek-reasoner | 深度推理 | claude-opus-4-5 |
141
+ | **Librarian** | 智谱(MCP)| glm-4.7 | 外部研究 | claude-sonnet-4-5 |
142
+ | **Explore** | DeepSeek(MCP)| deepseek-chat | 代码库搜索 | claude-haiku-4-5 |
143
+ | **Frontend-UI-UX** | 智谱(MCP)| glm-4v-flash | 视觉/UI 设计 | claude-sonnet-4-5 |
144
+ | **Document-Writer** | MiniMax(MCP)| MiniMax-M2.1 | 文档编写 | claude-sonnet-4-5 |
145
+
146
+ ### 自动降级
147
+
148
+ 当供应商的 API 密钥未配置时,MCP 智能体会自动降级到 Claude 模型:
149
+
150
+ - **Oracle** → `claude-opus-4-5`(保持深度推理能力)
151
+ - **Librarian** → `claude-sonnet-4-5`(平衡的研究能力)
152
+ - **Explore** → `claude-haiku-4-5`(快速搜索操作)
153
+ - **Frontend-UI-UX** → `claude-sonnet-4-5`(优质视觉设计)
154
+ - **Document-Writer** → `claude-sonnet-4-5`(优质文档编写)
155
+
156
+ 这使得 oh-my-claude 即使没有外部 API 密钥也能通过 Claude Code 订阅正常工作。
115
157
 
116
158
  ## 官方 MCP 服务
117
159
 
@@ -134,6 +176,11 @@ npx @lgcyaxi/oh-my-claude install # 安装 oh-my-claude
134
176
  npx @lgcyaxi/oh-my-claude install --force # 强制重新安装
135
177
  npx @lgcyaxi/oh-my-claude install --skip-mcp # 跳过 MCP 服务设置
136
178
 
179
+ # 更新
180
+ npx @lgcyaxi/oh-my-claude update # 更新到最新版本
181
+ npx @lgcyaxi/oh-my-claude update --check # 仅检查更新
182
+ npx @lgcyaxi/oh-my-claude update --force # 强制重新安装最新版
183
+
137
184
  # 状态和诊断
138
185
  npx @lgcyaxi/oh-my-claude status # 检查安装状态
139
186
  npx @lgcyaxi/oh-my-claude doctor # 诊断配置
@@ -8,7 +8,7 @@
8
8
 
9
9
  import { existsSync } from "node:fs";
10
10
  import { join, dirname } from "node:path";
11
- import { fileURLToPath } from "node:url";
11
+ import { fileURLToPath, pathToFileURL } from "node:url";
12
12
 
13
13
  const __dirname = dirname(fileURLToPath(import.meta.url));
14
14
  const distCli = join(__dirname, "..", "dist", "cli.js");
@@ -17,7 +17,9 @@ const srcCli = join(__dirname, "..", "src", "cli.ts");
17
17
  async function main() {
18
18
  if (existsSync(distCli)) {
19
19
  // Use compiled version
20
- await import(distCli);
20
+ // Convert to file:// URL for Windows compatibility
21
+ const distCliUrl = pathToFileURL(distCli).href;
22
+ await import(distCliUrl);
21
23
  } else if (existsSync(srcCli)) {
22
24
  // Fall back to source (requires Bun)
23
25
  const { spawn } = await import("node:child_process");
@@ -0,0 +1,28 @@
1
+ # v1.0.0 - 2025-01-15
2
+
3
+ Initial release of oh-my-claude.
4
+
5
+ ## Added
6
+
7
+ - **Multi-provider MCP server** supporting DeepSeek, ZhiPu GLM, and MiniMax via Anthropic-compatible APIs
8
+ - **Specialized agent workflows**:
9
+ - Sisyphus - Primary orchestrator (Claude Opus 4.5)
10
+ - Claude-Reviewer - Code review and QA (Claude Sonnet 4.5)
11
+ - Claude-Scout - Fast exploration (Claude Haiku 4.5)
12
+ - Prometheus - Strategic planning (Claude Opus 4.5)
13
+ - Oracle - Deep reasoning (DeepSeek reasoner)
14
+ - Librarian - External research (ZhiPu GLM)
15
+ - Explore - Codebase search (DeepSeek chat)
16
+ - Frontend-UI-UX - Visual/UI design (ZhiPu GLM-4v)
17
+ - Document-Writer - Documentation (MiniMax)
18
+ - **Slash commands**:
19
+ - Agent commands: `/omc-sisyphus`, `/omc-oracle`, `/omc-librarian`, `/omc-reviewer`, `/omc-scout`, `/omc-explore`, `/omc-plan`, `/omc-start-work`
20
+ - Quick actions: `/omcx-commit`, `/omcx-implement`, `/omcx-refactor`, `/omcx-docs`
21
+ - **CLI commands**:
22
+ - `install` - Install oh-my-claude into Claude Code
23
+ - `uninstall` - Remove oh-my-claude
24
+ - `status` - Check installation status
25
+ - `doctor` - Diagnose configuration with detailed component status
26
+ - `setup-mcp` - Install official MCP servers (Sequential Thinking, MiniMax, GLM)
27
+ - **Hook integration** for code quality checks and todo tracking
28
+ - **Concurrent execution** with per-provider rate limiting
@@ -0,0 +1,28 @@
1
+ # v1.0.1 - 2025-01-15
2
+
3
+ Patch release with Windows fix, self-update command, and automatic fallback support.
4
+
5
+ ## Added
6
+
7
+ - **Self-update command**: `npx @lgcyaxi/oh-my-claude update`
8
+ - Check current vs latest version from npm registry
9
+ - `--check` option to only check for updates without installing
10
+ - `--force` option to force reinstall even if already on latest version
11
+ - Automatically clears npx cache and runs install with @latest tag
12
+
13
+ - **Automatic fallback to Claude models**: MCP agents now automatically fall back to Claude models via Task tool when their provider's API key is not configured:
14
+ | Agent | Primary Provider | Fallback Model |
15
+ |-------|-----------------|----------------|
16
+ | Oracle | DeepSeek | claude-opus-4-5 |
17
+ | Librarian | ZhiPu | claude-sonnet-4-5 |
18
+ | Explore | DeepSeek | claude-haiku-4-5 |
19
+ | Frontend-UI-UX | ZhiPu | claude-sonnet-4-5 |
20
+ | Document-Writer | MiniMax | claude-sonnet-4-5 |
21
+
22
+ This allows oh-my-claude to work with Claude Code's subscription even without external API keys.
23
+
24
+ ## Fixed
25
+
26
+ - **Windows compatibility**: Fixed `ERR_UNSUPPORTED_ESM_URL_SCHEME` error on Windows
27
+ - Used `pathToFileURL()` for dynamic imports in bin/oh-my-claude.js
28
+ - Converts paths like `C:\...` to proper `file:///C:/...` URLs
@@ -0,0 +1,20 @@
1
+ # v1.1.0 - 2026-01-15
2
+
3
+ Feature release with bug reporting command and GitHub issue templates.
4
+
5
+ ## Added
6
+
7
+ - **Bug reporting command**: `/omcx-issue`
8
+ - Report bugs directly to oh-my-claude GitHub Issues
9
+ - Auto-collects environment diagnostics (version, OS, runtime, installation method)
10
+ - Runs `oh-my-claude doctor` to gather configuration status
11
+ - Interactive draft workflow - review before submitting
12
+ - Uses GitHub MCP tools for issue creation
13
+ - Handles both global and npx installations
14
+ - Falls back to manual reporting URL if GitHub MCP unavailable
15
+
16
+ - **GitHub Issue Templates**: `.github/ISSUE_TEMPLATE/bug_report.md`
17
+ - Structured bug report template for manual submissions
18
+ - Includes environment info table
19
+ - Doctor output section for diagnostics
20
+ - Consistent format with `/omcx-issue` command output
@@ -0,0 +1,71 @@
1
+ # v1.1.1
2
+
3
+ Release date: 2026-01-16
4
+
5
+ ## Features
6
+
7
+ ### Real-Time StatusLine
8
+
9
+ Added a persistent status bar that displays in Claude Code showing:
10
+ - Active MCP background agents with elapsed time
11
+ - Active Task tool agents (Claude-subscription agents) with `@` prefix
12
+ - Provider concurrency slots (DeepSeek, ZhiPu, MiniMax)
13
+ - Idle state with available slots
14
+
15
+ **StatusLine Format:**
16
+ ```
17
+ omc ready | DS: 10 ZP: 10 MM: 5 # Idle
18
+ omc [Oracle: 32s] [@Scout: 15s] | DS: 1/10 ... # Active
19
+ ```
20
+
21
+ ### Task Tool Agent Tracking
22
+
23
+ New `task-tracker` hook monitors Claude Code's Task tool to track:
24
+ - Claude-Reviewer, Claude-Scout, and other Task-based agents
25
+ - Launch and completion times
26
+ - Completion notifications in output
27
+
28
+ ### StatusLine CLI
29
+
30
+ New CLI subcommand for statusline management:
31
+ ```bash
32
+ oh-my-claude statusline --status # Check status
33
+ oh-my-claude statusline --enable # Enable
34
+ oh-my-claude statusline --disable # Disable
35
+ ```
36
+
37
+ ### Multi-Line StatusLine Support
38
+
39
+ When users have an existing statusline (like CCometixLine), oh-my-claude automatically:
40
+ - Creates a wrapper script that calls both
41
+ - Displays outputs on separate lines for visibility
42
+ - Backs up the original configuration
43
+
44
+ ## Changes
45
+
46
+ - Updated `doctor` command to show statusline status
47
+ - StatusLine automatically installed during `oh-my-claude install`
48
+ - Status file written to `~/.claude/oh-my-claude/status.json`
49
+ - MCP server writes initial status on startup
50
+
51
+ ## Hooks
52
+
53
+ New hooks added:
54
+ - `task-tracker` (PreToolUse:Task) - Track Task agent launches
55
+ - `task-tracker` (PostToolUse:Task) - Track Task agent completions
56
+
57
+ ## Files
58
+
59
+ New files:
60
+ - `src/statusline/statusline.ts` - Main statusline script
61
+ - `src/statusline/formatter.ts` - Status formatting utilities
62
+ - `src/hooks/task-tracker.ts` - Task tool tracking hook
63
+ - `src/installer/statusline-merger.ts` - StatusLine configuration merger
64
+
65
+ Modified files:
66
+ - `src/cli.ts` - Added statusline subcommand
67
+ - `src/installer/index.ts` - StatusLine installation
68
+ - `src/installer/settings-merger.ts` - Hook installation for task-tracker
69
+ - `src/mcp/background-agent-server/task-manager.ts` - Status file writer
70
+ - `src/mcp/background-agent-server/server.ts` - Initial status on startup
71
+ - `package.json` - Build scripts for statusline