@jwitmann/operator-helper 0.0.0-stage → 1.11.0

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 (3) hide show
  1. package/README.md +68 -2
  2. package/dist/index.js +18459 -0
  3. package/package.json +48 -4
package/README.md CHANGED
@@ -1,3 +1,69 @@
1
- # Temporary Holding Version
1
+ # Operator Helper
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Operator Memory: Durable context for agent-driven development.
4
+
5
+ Operator Helper installs and manages Operator Memory, an agent-driven development framework that turns agent work into lasting project knowledge through continuous documentation.
6
+
7
+ ### Install
8
+
9
+ Operator Helper requires Node.js 20 or newer.
10
+
11
+ ```sh
12
+ npm install --global @jwitmann/operator-helper
13
+ ```
14
+
15
+ Or with Bun:
16
+
17
+ ```sh
18
+ bun add --global --minimum-release-age 0 @jwitmann/operator-helper@latest
19
+ ```
20
+
21
+ Install an adapter:
22
+
23
+ ```sh
24
+ # OpenCode (V2)
25
+ operator-helper install opencode
26
+
27
+ # OpenCode 1 (legacy)
28
+ operator-helper install opencode-v1
29
+
30
+ # Pi
31
+ operator-helper install pi
32
+
33
+ # DeepSeek Harness
34
+ operator-helper install deepseek
35
+
36
+ # Kiro
37
+ operator-helper install kiro
38
+ ```
39
+
40
+ OpenCode defaults to V2; `install opencode-v1` is the explicit legacy route. Existing plugin registrations are not migrated automatically.
41
+
42
+ Restart the harness, then run `/operator:user-init` in a new conversation to begin setup.
43
+
44
+ ### Usage
45
+
46
+ Users interact with Operator through the harness commands `/operator:user-init`, `/operator:project-init`, and `/operator:index`. These commands guide the working agent, which uses Operator Helper for setup, status, and validation.
47
+
48
+ Run each Operator command in a new conversation so the agent can focus on that operation with a clean working context. Initialization preserves existing content. Project setup configures `.operator/` in the global Git ignore but does not automatically untrack files already committed.
49
+
50
+ The direct user-facing Helper operation is adapter installation:
51
+
52
+ ```sh
53
+ operator-helper install opencode
54
+ operator-helper install opencode-v1
55
+ operator-helper install pi
56
+ operator-helper install deepseek
57
+ operator-helper install kiro
58
+ ```
59
+
60
+ Operator Helper automatically checks for and installs updates when commands run. If it cannot determine whether Bun or npm owns the global installation, it asks for a manual update using the original installation method.
61
+
62
+ ### Documentation
63
+
64
+ - [Overview and setup](https://github.com/jwitmann/operator-memory#readme)
65
+ - [Getting Started](https://github.com/jwitmann/operator-memory/blob/main/docs/getting-started.md)
66
+ - [Architecture](https://github.com/jwitmann/operator-memory/blob/main/docs/architecture.md)
67
+ - [Troubleshooting](https://github.com/jwitmann/operator-memory/blob/main/docs/troubleshooting.md)
68
+
69
+ Licensed under the BSD 3-Clause License.