@unitsvc/cc-helper 1.0.13 → 1.0.15

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 (6) hide show
  1. package/LICENSE +661 -661
  2. package/README-zh.md +173 -155
  3. package/README.md +173 -155
  4. package/dist/cli.js +1 -1
  5. package/dist/index.js +1 -1
  6. package/package.json +47 -47
package/README-zh.md CHANGED
@@ -1,155 +1,173 @@
1
- # cc-helper
2
-
3
- [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper)
4
- [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
5
- [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
6
-
7
- [**English**](./README.md) | **简体中文**
8
-
9
- > ⚡ 一键启用 Claude Code CLI 的 `/loop` 功能
10
-
11
- ## 环境要求
12
-
13
- - Node.js >= 14.0.0
14
- - Claude Code v2.1.71+
15
-
16
- ```bash
17
- npm install -g @anthropic-ai/claude-code@v2.1.71
18
- ```
19
-
20
- ## 使用方法
21
-
22
- ```bash
23
- # 启用 /loop 功能
24
- npx @unitsvc/cc-helper enable
25
-
26
- # 查看状态
27
- npx @unitsvc/cc-helper status
28
-
29
- # 禁用 /loop 功能（恢复原状）
30
- npx @unitsvc/cc-helper disable
31
- ```
32
-
33
- ### 代理支持
34
-
35
- 如果下载失败，使用 `--proxy` 参数：
36
-
37
- ```bash
38
- # 使用默认代理 (https://edgeone.gh-proxy.org)
39
- npx @unitsvc/cc-helper --proxy enable
40
-
41
- # 使用自定义代理
42
- npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
43
- ```
44
-
45
- ### 命令说明
46
-
47
- | 命令 | 说明 |
48
- | --------- | ----------------- |
49
- | `enable` | 启用 `/loop` 功能 |
50
- | `disable` | 恢复原始状态 |
51
- | `status` | 查看当前状态 |
52
-
53
- ## 赞助
54
-
55
- <table>
56
- <tr>
57
- <td width="60" valign="middle">
58
- <img src="https://img.shields.io/badge/🚀-GLM-blue?style=for-the-badge" alt="GLM"/>
59
- </td>
60
- <td valign="middle">
61
- <b>GLM Coding Plan</b><br/>
62
- <sub>Full support for <b>Claude Code</b>, <b>Cline</b>, and <b>20+ top coding tools</b> — starting at just <b>$10/month</b></sub><br/>
63
- <a href="https://z.ai/subscribe?ic=1YVKN4IRCQ"><b>👉 Subscribe now — limited-time deal!</b></a>
64
- </td>
65
- </tr>
66
- </table>
67
-
68
- ---
69
-
70
- ## 什么是 `/loop`？
71
-
72
- `/loop` 是 Claude Code CLI 的内置命令，用于创建定时重复提示。适用于：
73
-
74
- - 轮询部署或构建状态
75
- - 监控 PR 状态
76
- - 设置提醒
77
- - 定时执行工作流
78
-
79
- ### 使用语法
80
-
81
- ```
82
- /loop [间隔时间] <提示内容>
83
- ```
84
-
85
- **示例：**
86
-
87
- ```
88
- /loop 5m check if the deployment finished
89
- /loop 30m /review-pr 1234
90
- /loop remind me to push the release at 3pm
91
- ```
92
-
93
- ### 间隔时间格式
94
-
95
- | 形式 | 示例 | 解析间隔 |
96
- | ---------- | --------------------------- | -------------- |
97
- | 前置时间 | `/loop 30m check` | 每 30 分钟 |
98
- | 后置 every | `/loop check every 2 hours` | 每 2 小时 |
99
- | 无间隔 | `/loop check` | 默认每 10 分钟 |
100
-
101
- 支持单位：`s`（秒）、`m`（分）、`h`（时）、`d`（天）
102
-
103
- ### 核心特性
104
-
105
- - **会话级别**：任务仅在当前 Claude Code 会话中存在，退出即消失
106
- - **自动过期**：重复任务 3 天后自动过期
107
- - **抖动保护**：添加小偏移量防止 API 惊群效应
108
- - **低优先级**：定时提示在你与 Claude 交互间隙触发
109
-
110
- ### 管理任务
111
-
112
- ```
113
- what scheduled tasks do I have? # 列出所有任务
114
- cancel the deploy check job # 按描述或 ID 取消
115
- ```
116
-
117
- ## 功能特点
118
-
119
- - 一键启用 `/loop` 功能
120
- - 轻松恢复原始状态
121
- - 自动备份原文件
122
- - 零运行时依赖
123
- - 跨平台支持
124
-
125
- ### 示例
126
-
127
- 启用后，在 Claude Code 中使用 `/loop` 命令：
128
-
129
- ![/loop 命令提示](./docs/images/loop-1.png)
130
-
131
- 执行 loop 命令示例：
132
-
133
- ![/loop 执行示例](./docs/images/loop-2.png)
134
-
135
- ## 支持平台
136
-
137
- - macOS (amd64, arm64)
138
- - Linux (amd64, arm64)
139
- - Windows (amd64, arm64)
140
-
141
- ## 许可证
142
-
143
- AGPL-3.0 - 详见 [LICENSE](./LICENSE)
144
-
145
- ## 安全
146
-
147
- ### 报告漏洞
148
-
149
- 如果您发现 cc-helper 的安全漏洞，请负责任地报告：
150
-
151
- 1. **不要**公开提 issue
152
- 2. 发送邮件给维护者说明详情
153
- 3. 给予合理时间修复后再公开
154
-
155
- 我们非常重视安全问题，会尽快响应。
1
+ # cc-helper
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper)
4
+ [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
5
+ [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
6
+
7
+ [**English**](./README.md) | **简体中文**
8
+
9
+ > ⚡ 一键启用 Claude Code CLI 的隐藏功能：`/loop` 和 `/btw`
10
+
11
+ ## 环境要求
12
+
13
+ - Node.js >= 14.0.0
14
+ - Claude Code v2.1.71+
15
+
16
+ ```bash
17
+ npm install -g @anthropic-ai/claude-code@v2.1.71
18
+ ```
19
+
20
+ ## 使用方法
21
+
22
+ ```bash
23
+ # 启用所有功能（默认）
24
+ npx @unitsvc/cc-helper enable
25
+
26
+ # 查看状态
27
+ npx @unitsvc/cc-helper status
28
+
29
+ # 禁用功能（恢复原状）
30
+ npx @unitsvc/cc-helper disable
31
+ ```
32
+
33
+ ### 代理支持
34
+
35
+ 如果下载失败，使用 `--proxy` 参数：
36
+
37
+ ```bash
38
+ # 使用默认代理 (https://edgeone.gh-proxy.org)
39
+ npx @unitsvc/cc-helper --proxy enable
40
+
41
+ # 使用自定义代理
42
+ npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
43
+ ```
44
+
45
+ ### 命令说明
46
+
47
+ | 命令 | 说明 |
48
+ | --------- | ----------------------- |
49
+ | `enable` | 启用 `/loop` 和 `/btw` 功能 |
50
+ | `disable` | 恢复原始状态 |
51
+ | `status` | 查看当前状态 |
52
+
53
+ ## 赞助
54
+
55
+ <table>
56
+ <tr>
57
+ <td width="60" valign="middle">
58
+ <img src="https://img.shields.io/badge/🚀-GLM-blue?style=for-the-badge" alt="GLM"/>
59
+ </td>
60
+ <td valign="middle">
61
+ <b>GLM Coding Plan</b><br/>
62
+ <sub>Full support for <b>Claude Code</b>, <b>Cline</b>, and <b>20+ top coding tools</b> — starting at just <b>$10/month</b></sub><br/>
63
+ <a href="https://z.ai/subscribe?ic=1YVKN4IRCQ"><b>👉 Subscribe now — limited-time deal!</b></a>
64
+ </td>
65
+ </tr>
66
+ </table>
67
+
68
+ ---
69
+
70
+ ## 什么是 `/loop`？
71
+
72
+ `/loop` 是 Claude Code CLI 的内置命令，用于创建定时重复提示。适用于：
73
+
74
+ - 轮询部署或构建状态
75
+ - 监控 PR 状态
76
+ - 设置提醒
77
+ - 定时执行工作流
78
+
79
+ ### 使用语法
80
+
81
+ ```
82
+ /loop [间隔时间] <提示内容>
83
+ ```
84
+
85
+ **示例：**
86
+
87
+ ```
88
+ /loop 5m check if the deployment finished
89
+ /loop 30m /review-pr 1234
90
+ /loop remind me to push the release at 3pm
91
+ ```
92
+
93
+ ### 间隔时间格式
94
+
95
+ | 形式 | 示例 | 解析间隔 |
96
+ | ---------- | --------------------------- | -------------- |
97
+ | 前置时间 | `/loop 30m check` | 每 30 分钟 |
98
+ | 后置 every | `/loop check every 2 hours` | 每 2 小时 |
99
+ | 无间隔 | `/loop check` | 默认每 10 分钟 |
100
+
101
+ 支持单位：`s`（秒）、`m`（分）、`h`（时）、`d`（天）
102
+
103
+ ### 核心特性
104
+
105
+ - **会话级别**：任务仅在当前 Claude Code 会话中存在，退出即消失
106
+ - **自动过期**：重复任务 3 天后自动过期
107
+ - **抖动保护**：添加小偏移量防止 API 惊群效应
108
+ - **低优先级**：定时提示在你与 Claude 交互间隙触发
109
+
110
+ ### 管理任务
111
+
112
+ ```
113
+ what scheduled tasks do I have? # 列出所有任务
114
+ cancel the deploy check job # 按描述或 ID 取消
115
+ ```
116
+
117
+ ## 什么是 `/btw`？
118
+
119
+ `/btw`（by the way）是一个隐藏命令，用于在不打断主对话流程的情况下提问旁支问题。适合快速澄清疑问。
120
+
121
+ ### 使用方法
122
+
123
+ ```
124
+ /btw <问题>
125
+ ```
126
+
127
+ **示例：**
128
+
129
+ ```
130
+ /btw 这个函数是做什么的？
131
+ /btw 解释一下这里的错误处理
132
+ /btw 为什么这里要用 async/await？
133
+ ```
134
+
135
+ ## 功能特点
136
+
137
+ - 一键启用 `/loop` 和 `/btw` 功能
138
+ - 轻松恢复原始状态
139
+ - 自动备份原文件
140
+ - 零运行时依赖
141
+ - 跨平台支持
142
+
143
+ ### 示例
144
+
145
+ 启用后，在 Claude Code 中使用 `/loop` 命令：
146
+
147
+ ![/loop 命令提示](./docs/images/loop-1.png)
148
+
149
+ 执行 loop 命令示例：
150
+
151
+ ![/loop 执行示例](./docs/images/loop-2.png)
152
+
153
+ ## 支持平台
154
+
155
+ - macOS (amd64, arm64)
156
+ - Linux (amd64, arm64)
157
+ - Windows (amd64, arm64)
158
+
159
+ ## 许可证
160
+
161
+ AGPL-3.0 - 详见 [LICENSE](./LICENSE)
162
+
163
+ ## 安全
164
+
165
+ ### 报告漏洞
166
+
167
+ 如果您发现 cc-helper 的安全漏洞，请负责任地报告：
168
+
169
+ 1. **不要**公开提 issue
170
+ 2. 发送邮件给维护者说明详情
171
+ 3. 给予合理时间修复后再公开
172
+
173
+ 我们非常重视安全问题，会尽快响应。
package/README.md CHANGED
@@ -1,155 +1,173 @@
1
- # cc-helper
2
-
3
- [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper)
4
- [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
5
- [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
6
-
7
- **English** | [**简体中文**](./README-zh.md)
8
-
9
- > ⚡ Enable the `/loop` feature in Claude Code CLI with one command
10
-
11
- ## Requirements
12
-
13
- - Node.js >= 14.0.0
14
- - Claude Code v2.1.71+
15
-
16
- ```bash
17
- npm install -g @anthropic-ai/claude-code@v2.1.71
18
- ```
19
-
20
- ## Usage
21
-
22
- ```bash
23
- # Enable /loop feature
24
- npx @unitsvc/cc-helper enable
25
-
26
- # Check status
27
- npx @unitsvc/cc-helper status
28
-
29
- # Disable /loop feature (restore original)
30
- npx @unitsvc/cc-helper disable
31
- ```
32
-
33
- ### Proxy Support
34
-
35
- If download fails, use `--proxy` flag:
36
-
37
- ```bash
38
- # Use default proxy (https://edgeone.gh-proxy.org)
39
- npx @unitsvc/cc-helper --proxy enable
40
-
41
- # Use custom proxy
42
- npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
43
- ```
44
-
45
- ### Commands
46
-
47
- | Command | Description |
48
- | -------- | ---------------------- |
49
- | `enable` | Enable `/loop` feature |
50
- | `disable`| Restore original |
51
- | `status` | Check current status |
52
-
53
- ## Sponsors
54
-
55
- <table>
56
- <tr>
57
- <td width="60" valign="middle">
58
- <img src="https://img.shields.io/badge/🚀-GLM-blue?style=for-the-badge" alt="GLM"/>
59
- </td>
60
- <td valign="middle">
61
- <b>GLM Coding Plan</b><br/>
62
- <sub>Full support for <b>Claude Code</b>, <b>Cline</b>, and <b>20+ top coding tools</b> — starting at just <b>$10/month</b></sub><br/>
63
- <a href="https://z.ai/subscribe?ic=1YVKN4IRCQ"><b>👉 Subscribe now — limited-time deal!</b></a>
64
- </td>
65
- </tr>
66
- </table>
67
-
68
- ---
69
-
70
- ## What is `/loop`?
71
-
72
- `/loop` is a built-in command in Claude Code CLI that lets you schedule recurring prompts. It's useful for:
73
-
74
- - Polling deployments or builds
75
- - Babysitting PRs
76
- - Setting reminders
77
- - Running workflows on an interval
78
-
79
- ### Usage Syntax
80
-
81
- ```
82
- /loop [interval] <prompt>
83
- ```
84
-
85
- **Examples:**
86
-
87
- ```
88
- /loop 5m check if the deployment finished
89
- /loop 30m /review-pr 1234
90
- /loop remind me to push the release at 3pm
91
- ```
92
-
93
- ### Interval Formats
94
-
95
- | Form | Example | Parsed Interval |
96
- | ----------------------- | --------------------------- | ---------------------------- |
97
- | Leading token | `/loop 30m check` | every 30 minutes |
98
- | Trailing `every` clause | `/loop check every 2 hours` | every 2 hours |
99
- | No interval | `/loop check` | defaults to every 10 minutes |
100
-
101
- Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days)
102
-
103
- ### Key Features
104
-
105
- - **Session-scoped**: Tasks live in the current Claude Code session and are gone when you exit
106
- - **Auto-expiry**: Recurring tasks expire after 3 days
107
- - **Jitter protection**: Adds small offsets to prevent API thundering herd
108
- - **Low priority**: Scheduled prompts fire between your turns, not while Claude is busy
109
-
110
- ### Managing Tasks
111
-
112
- ```
113
- what scheduled tasks do I have? # List all tasks
114
- cancel the deploy check job # Cancel by description or ID
115
- ```
116
-
117
- ## Features
118
-
119
- - Enable `/loop` with one command
120
- - Easy restore functionality
121
- - Automatic backup
122
- - Zero runtime dependencies
123
- - Cross-platform support
124
-
125
- ### Examples
126
-
127
- After enabling, use the `/loop` command in Claude Code:
128
-
129
- ![/loop command hint](./docs/images/loop-1.png)
130
-
131
- Example of executing a loop command:
132
-
133
- ![/loop execution example](./docs/images/loop-2.png)
134
-
135
- ## Platforms
136
-
137
- - macOS (amd64, arm64)
138
- - Linux (amd64, arm64)
139
- - Windows (amd64, arm64)
140
-
141
- ## License
142
-
143
- AGPL-3.0 - see [LICENSE](./LICENSE)
144
-
145
- ## Security
146
-
147
- ### Reporting Vulnerabilities
148
-
149
- If you discover a security vulnerability in cc-helper, please report it responsibly:
150
-
151
- 1. **Do not** open a public issue
152
- 2. Send an email to the maintainer with details
153
- 3. Allow reasonable time for the issue to be addressed before public disclosure
154
-
155
- We take security seriously and will respond to reports as quickly as possible.
1
+ # cc-helper
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper)
4
+ [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
5
+ [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
6
+
7
+ **English** | [**简体中文**](./README-zh.md)
8
+
9
+ > ⚡ Enable hidden features in Claude Code CLI with one command: `/loop` and `/btw`
10
+
11
+ ## Requirements
12
+
13
+ - Node.js >= 14.0.0
14
+ - Claude Code v2.1.71+
15
+
16
+ ```bash
17
+ npm install -g @anthropic-ai/claude-code@v2.1.71
18
+ ```
19
+
20
+ ## Usage
21
+
22
+ ```bash
23
+ # Enable all features (default)
24
+ npx @unitsvc/cc-helper enable
25
+
26
+ # Check status
27
+ npx @unitsvc/cc-helper status
28
+
29
+ # Disable all features (restore original)
30
+ npx @unitsvc/cc-helper disable
31
+ ```
32
+
33
+ ### Commands
34
+
35
+ | Command | Description |
36
+ | --------- | ------------------------ |
37
+ | `enable` | Enable `/loop` and `/btw` features |
38
+ | `disable` | Restore original |
39
+ | `status` | Check current status |
40
+
41
+ ### Proxy Support
42
+
43
+ If download fails, use `--proxy` flag:
44
+
45
+ ```bash
46
+ # Use default proxy (https://edgeone.gh-proxy.org)
47
+ npx @unitsvc/cc-helper --proxy enable
48
+
49
+ # Use custom proxy
50
+ npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
51
+ ```
52
+
53
+ ## Sponsors
54
+
55
+ <table>
56
+ <tr>
57
+ <td width="60" valign="middle">
58
+ <img src="https://img.shields.io/badge/🚀-GLM-blue?style=for-the-badge" alt="GLM"/>
59
+ </td>
60
+ <td valign="middle">
61
+ <b>GLM Coding Plan</b><br/>
62
+ <sub>Full support for <b>Claude Code</b>, <b>Cline</b>, and <b>20+ top coding tools</b> — starting at just <b>$10/month</b></sub><br/>
63
+ <a href="https://z.ai/subscribe?ic=1YVKN4IRCQ"><b>👉 Subscribe now — limited-time deal!</b></a>
64
+ </td>
65
+ </tr>
66
+ </table>
67
+
68
+ ---
69
+
70
+ ## What is `/loop`?
71
+
72
+ `/loop` is a built-in command in Claude Code CLI that lets you schedule recurring prompts. It's useful for:
73
+
74
+ - Polling deployments or builds
75
+ - Babysitting PRs
76
+ - Setting reminders
77
+ - Running workflows on an interval
78
+
79
+ ### Usage Syntax
80
+
81
+ ```
82
+ /loop [interval] <prompt>
83
+ ```
84
+
85
+ **Examples:**
86
+
87
+ ```
88
+ /loop 5m check if the deployment finished
89
+ /loop 30m /review-pr 1234
90
+ /loop remind me to push the release at 3pm
91
+ ```
92
+
93
+ ### Interval Formats
94
+
95
+ | Form | Example | Parsed Interval |
96
+ | ----------------------- | --------------------------- | ---------------------------- |
97
+ | Leading token | `/loop 30m check` | every 30 minutes |
98
+ | Trailing `every` clause | `/loop check every 2 hours` | every 2 hours |
99
+ | No interval | `/loop check` | defaults to every 10 minutes |
100
+
101
+ Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days)
102
+
103
+ ### Key Features
104
+
105
+ - **Session-scoped**: Tasks live in the current Claude Code session and are gone when you exit
106
+ - **Auto-expiry**: Recurring tasks expire after 3 days
107
+ - **Jitter protection**: Adds small offsets to prevent API thundering herd
108
+ - **Low priority**: Scheduled prompts fire between your turns, not while Claude is busy
109
+
110
+ ### Managing Tasks
111
+
112
+ ```
113
+ what scheduled tasks do I have? # List all tasks
114
+ cancel the deploy check job # Cancel by description or ID
115
+ ```
116
+
117
+ ## What is `/btw`?
118
+
119
+ `/btw` (by the way) is a hidden command for asking side questions without disrupting the main conversation flow. Perfect for quick clarifications.
120
+
121
+ ### Usage
122
+
123
+ ```
124
+ /btw <question>
125
+ ```
126
+
127
+ **Examples:**
128
+
129
+ ```
130
+ /btw what does this function do?
131
+ /btw explain the error handling here
132
+ /btw why use async/await in this case?
133
+ ```
134
+
135
+ ## Features
136
+
137
+ - Enable `/loop` and `/btw` with one command
138
+ - Easy restore functionality
139
+ - Automatic backup
140
+ - Zero runtime dependencies
141
+ - Cross-platform support
142
+
143
+ ### Examples
144
+
145
+ After enabling, use the `/loop` command in Claude Code:
146
+
147
+ ![/loop command hint](./docs/images/loop-1.png)
148
+
149
+ Example of executing a loop command:
150
+
151
+ ![/loop execution example](./docs/images/loop-2.png)
152
+
153
+ ## Platforms
154
+
155
+ - macOS (amd64, arm64)
156
+ - Linux (amd64, arm64)
157
+ - Windows (amd64, arm64)
158
+
159
+ ## License
160
+
161
+ AGPL-3.0 - see [LICENSE](./LICENSE)
162
+
163
+ ## Security
164
+
165
+ ### Reporting Vulnerabilities
166
+
167
+ If you discover a security vulnerability in cc-helper, please report it responsibly:
168
+
169
+ 1. **Do not** open a public issue
170
+ 2. Send an email to the maintainer with details
171
+ 3. Allow reasonable time for the issue to be addressed before public disclosure
172
+
173
+ We take security seriously and will respond to reports as quickly as possible.