@unitsvc/cc-helper 1.0.7 → 1.0.8

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 (7) hide show
  1. package/LICENSE +661 -661
  2. package/README.md +126 -126
  3. package/bin/cc-helper.js +411 -411
  4. package/index.js +9 -9
  5. package/install.js +374 -373
  6. package/package.json +38 -38
  7. package/uninstall.js +23 -23
package/README.md CHANGED
@@ -1,126 +1,126 @@
1
- # cc-helper
2
-
3
- > Enable/disable the `/loop` feature in Claude Code CLI
4
-
5
- ## Requirements
6
-
7
- - Claude Code v2.1.71+
8
-
9
- ```bash
10
- npm install -g @anthropic-ai/claude-code@v2.1.71
11
- ```
12
-
13
- ## Installation
14
-
15
- ```bash
16
- # Using npx (no install)
17
- npx @unitsvc/cc-helper enable
18
-
19
- # Or install globally
20
- npm install -g @unitsvc/cc-helper
21
- cc-helper enable
22
- ```
23
-
24
- ## Usage
25
-
26
- ### Command
27
-
28
- | Command | Description |
29
- | --------------------- | ----------------------- |
30
- | `cc-helper enable` | Enable `/loop` feature |
31
- | `cc-helper disable` | Restore original |
32
- | `cc-helper status` | Check current status |
33
- | `cc-helper uninstall` | Uninstall (clean cache) |
34
-
35
- ## Sponsors
36
-
37
- 🚀 **GLM Coding Plan**
38
-
39
- 👉 [Enjoy full support for Claude Code, Cline, and 20+ top coding tools — starting at just $10/month. Subscribe now and grab the limited-time deal!](https://z.ai/subscribe?ic=1YVKN4IRCQ)
40
-
41
- ---
42
-
43
- ## What is `/loop`?
44
-
45
- `/loop` is a built-in command in Claude Code CLI that lets you schedule recurring prompts. It's useful for:
46
-
47
- - Polling deployments or builds
48
- - Babysitting PRs
49
- - Setting reminders
50
- - Running workflows on an interval
51
-
52
- ### Usage Syntax
53
-
54
- ```
55
- /loop [interval] <prompt>
56
- ```
57
-
58
- **Examples:**
59
-
60
- ```
61
- /loop 5m check if the deployment finished
62
- /loop 30m /review-pr 1234
63
- /loop remind me to push the release at 3pm
64
- ```
65
-
66
- ### Interval Formats
67
-
68
- | Form | Example | Parsed Interval |
69
- | ----------------------- | --------------------------- | ---------------------------- |
70
- | Leading token | `/loop 30m check` | every 30 minutes |
71
- | Trailing `every` clause | `/loop check every 2 hours` | every 2 hours |
72
- | No interval | `/loop check` | defaults to every 10 minutes |
73
-
74
- Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days)
75
-
76
- ### Key Features
77
-
78
- - **Session-scoped**: Tasks live in the current Claude Code session and are gone when you exit
79
- - **Auto-expiry**: Recurring tasks expire after 3 days
80
- - **Jitter protection**: Adds small offsets to prevent API thundering herd
81
- - **Low priority**: Scheduled prompts fire between your turns, not while Claude is busy
82
-
83
- ### Managing Tasks
84
-
85
- ```
86
- what scheduled tasks do I have? # List all tasks
87
- cancel the deploy check job # Cancel by description or ID
88
- ```
89
-
90
- ## Features
91
-
92
- - Enable `/loop` with one command
93
- - Easy restore functionality
94
- - Automatic backup
95
-
96
- ### Examples
97
-
98
- After enabling, use the `/loop` command in Claude Code:
99
-
100
- ![/loop command hint](./docs/images/loop-1.png)
101
-
102
- Example of executing a loop command:
103
-
104
- ![/loop execution example](./docs/images/loop-2.png)
105
-
106
- ## Platforms
107
-
108
- - macOS (amd64, arm64)
109
- - Linux (amd64, arm64)
110
- - Windows (amd64)
111
-
112
- ## License
113
-
114
- AGPL-3.0 - see [LICENSE](./LICENSE)
115
-
116
- ## Security
117
-
118
- ### Reporting Vulnerabilities
119
-
120
- If you discover a security vulnerability in cc-helper, please report it responsibly:
121
-
122
- 1. **Do not** open a public issue
123
- 2. Send an email to the maintainer with details
124
- 3. Allow reasonable time for the issue to be addressed before public disclosure
125
-
126
- We take security seriously and will respond to reports as quickly as possible.
1
+ # cc-helper
2
+
3
+ > Enable/disable the `/loop` feature in Claude Code CLI
4
+
5
+ ## Requirements
6
+
7
+ - Claude Code v2.1.71+
8
+
9
+ ```bash
10
+ npm install -g @anthropic-ai/claude-code@v2.1.71
11
+ ```
12
+
13
+ ## Installation
14
+
15
+ ```bash
16
+ # Using npx (no install)
17
+ npx @unitsvc/cc-helper enable
18
+
19
+ # Or install globally
20
+ npm install -g @unitsvc/cc-helper
21
+ cc-helper enable
22
+ ```
23
+
24
+ ## Usage
25
+
26
+ ### Command
27
+
28
+ | Command | Description |
29
+ | --------------------- | ----------------------- |
30
+ | `cc-helper enable` | Enable `/loop` feature |
31
+ | `cc-helper disable` | Restore original |
32
+ | `cc-helper status` | Check current status |
33
+ | `cc-helper uninstall` | Uninstall (clean cache) |
34
+
35
+ ## Sponsors
36
+
37
+ 🚀 **GLM Coding Plan**
38
+
39
+ 👉 [Enjoy full support for Claude Code, Cline, and 20+ top coding tools — starting at just $10/month. Subscribe now and grab the limited-time deal!](https://z.ai/subscribe?ic=1YVKN4IRCQ)
40
+
41
+ ---
42
+
43
+ ## What is `/loop`?
44
+
45
+ `/loop` is a built-in command in Claude Code CLI that lets you schedule recurring prompts. It's useful for:
46
+
47
+ - Polling deployments or builds
48
+ - Babysitting PRs
49
+ - Setting reminders
50
+ - Running workflows on an interval
51
+
52
+ ### Usage Syntax
53
+
54
+ ```
55
+ /loop [interval] <prompt>
56
+ ```
57
+
58
+ **Examples:**
59
+
60
+ ```
61
+ /loop 5m check if the deployment finished
62
+ /loop 30m /review-pr 1234
63
+ /loop remind me to push the release at 3pm
64
+ ```
65
+
66
+ ### Interval Formats
67
+
68
+ | Form | Example | Parsed Interval |
69
+ | ----------------------- | --------------------------- | ---------------------------- |
70
+ | Leading token | `/loop 30m check` | every 30 minutes |
71
+ | Trailing `every` clause | `/loop check every 2 hours` | every 2 hours |
72
+ | No interval | `/loop check` | defaults to every 10 minutes |
73
+
74
+ Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days)
75
+
76
+ ### Key Features
77
+
78
+ - **Session-scoped**: Tasks live in the current Claude Code session and are gone when you exit
79
+ - **Auto-expiry**: Recurring tasks expire after 3 days
80
+ - **Jitter protection**: Adds small offsets to prevent API thundering herd
81
+ - **Low priority**: Scheduled prompts fire between your turns, not while Claude is busy
82
+
83
+ ### Managing Tasks
84
+
85
+ ```
86
+ what scheduled tasks do I have? # List all tasks
87
+ cancel the deploy check job # Cancel by description or ID
88
+ ```
89
+
90
+ ## Features
91
+
92
+ - Enable `/loop` with one command
93
+ - Easy restore functionality
94
+ - Automatic backup
95
+
96
+ ### Examples
97
+
98
+ After enabling, use the `/loop` command in Claude Code:
99
+
100
+ ![/loop command hint](./docs/images/loop-1.png)
101
+
102
+ Example of executing a loop command:
103
+
104
+ ![/loop execution example](./docs/images/loop-2.png)
105
+
106
+ ## Platforms
107
+
108
+ - macOS (amd64, arm64)
109
+ - Linux (amd64, arm64)
110
+ - Windows (amd64)
111
+
112
+ ## License
113
+
114
+ AGPL-3.0 - see [LICENSE](./LICENSE)
115
+
116
+ ## Security
117
+
118
+ ### Reporting Vulnerabilities
119
+
120
+ If you discover a security vulnerability in cc-helper, please report it responsibly:
121
+
122
+ 1. **Do not** open a public issue
123
+ 2. Send an email to the maintainer with details
124
+ 3. Allow reasonable time for the issue to be addressed before public disclosure
125
+
126
+ We take security seriously and will respond to reports as quickly as possible.