@growthub/cli 0.7.3 → 0.7.4

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 (2) hide show
  1. package/README.md +79 -57
  2. package/package.json +6 -1
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # @growthub/cli
2
2
 
3
- `@growthub/cli` is the public CLI for Growthub Local.
3
+ `@growthub/cli` is the CLI control plane for Growthub Local.
4
+
5
+ It helps you turn a repo, skill, starter, or kit into a governed local agent environment you can customize, keep current, and optionally activate with hosted authority.
4
6
 
5
7
  ## Install
6
8
 
@@ -8,68 +10,82 @@
8
10
  npm install -g @growthub/cli
9
11
  ```
10
12
 
11
- Or use the guided installer:
13
+ Or start with the guided installer:
12
14
 
13
15
  ```bash
14
- # Interactive discovery hub
15
16
  npm create growthub-local@latest
17
+ ```
18
+
19
+ ## Profile-first setup (recommended)
20
+
21
+ The guided flow is profile-first before deeper harness/workflow choices:
16
22
 
17
- # Paperclip Local App profiles
23
+ ```bash
18
24
  npm create growthub-local@latest -- --profile gtm
19
25
  npm create growthub-local@latest -- --profile dx
20
-
21
- # Custom Workspace Starter (scaffold + register as a fork in one shot)
22
26
  npm create growthub-local@latest -- --profile workspace --out ./my-workspace
23
27
  ```
24
28
 
25
- ## At a Glance
29
+ ## Discovery lanes
26
30
 
27
- The CLI ships these user flows:
31
+ Main entry:
28
32
 
29
- - `Agent Harness` (Paperclip Local App, Open Agents, Qwen Code CLI)
30
- - `Worker Kits`
31
- - `Templates`
32
- - `Workflows`
33
- - `Local Intelligence`
34
- - `Hosted Auth Bridge`
33
+ ```bash
34
+ growthub discover
35
+ ```
36
+
37
+ Core lanes:
35
38
 
36
- ## Quick Commands
39
+ 1. Worker Kits
40
+ 2. Templates
41
+ 3. Workflows
42
+ 4. Local Intelligence
43
+ 5. Agent Harness
44
+ 6. Settings / account connection
45
+
46
+ ## Main commands
37
47
 
38
48
  ```bash
39
- # Discovery
40
49
  growthub
41
50
  growthub discover
42
51
 
43
- # Agent Harness
44
- growthub onboard
45
- growthub run
46
- growthub open-agents
47
- growthub qwen-code
48
-
49
- # Worker Kits
50
52
  growthub kit
51
- growthub kit list
52
- growthub kit inspect <kit-id>
53
- growthub kit download <kit-id>
54
- growthub kit validate <path>
55
-
56
- # Templates
57
53
  growthub template
58
- growthub template list
59
- growthub template get <slug>
60
-
61
- # Workflows
62
54
  growthub workflow
63
- growthub workflow saved
64
55
  growthub pipeline assemble
65
56
 
66
- # Hosted Auth Bridge
57
+ growthub open-agents
58
+ growthub qwen-code
59
+
67
60
  growthub auth login
68
61
  growthub auth whoami
69
62
  growthub auth logout
70
63
  ```
71
64
 
72
- ## Worker Kit Command Surface
65
+ <details>
66
+ <summary><strong>Command examples</strong></summary>
67
+
68
+ ### Discovery
69
+
70
+ ```bash
71
+ growthub discover
72
+ ```
73
+
74
+ Example:
75
+
76
+ ```text
77
+ Open the interactive hub and choose a lane by outcome (kit/template/workflow/harness/auth).
78
+ ```
79
+
80
+ ### Kits
81
+
82
+ ```bash
83
+ growthub kit list
84
+ growthub kit inspect <kit-id>
85
+ growthub kit download <kit-id>
86
+ ```
87
+
88
+ Compatibility examples used by package validation:
73
89
 
74
90
  ```bash
75
91
  growthub kit list
@@ -87,36 +103,42 @@ growthub kit validate /absolute/path/to/kit
87
103
  2. Point the agent working directory at the exported folder.
88
104
  3. Start a new session so the kit contract loads from `CLAUDE.md`.
89
105
 
90
- ## Harness Notes
106
+ ### Workflows + pipelines
91
107
 
92
- ### Open Agents
108
+ ```bash
109
+ growthub workflow
110
+ growthub pipeline assemble
111
+ ```
93
112
 
94
- - upstream: [vercel-labs/open-agents](https://github.com/vercel-labs/open-agents)
95
- - secure auth mode support: `none`, `api-key`, `vercel-managed`
96
- - prompt/chat commands: `growthub open-agents prompt`, `growthub open-agents chat`
113
+ ### Harnesses
114
+
115
+ ```bash
116
+ growthub open-agents
117
+ growthub qwen-code
118
+ ```
97
119
 
98
- ### Qwen Code CLI
120
+ ### Account connection
99
121
 
100
- - upstream: [QwenLM/qwen-code](https://github.com/QwenLM/qwen-code)
101
- - secure local key setup from `growthub qwen-code` configure flow
102
- - prompt/chat session commands: `growthub qwen-code prompt`, `growthub qwen-code session`
122
+ ```bash
123
+ growthub auth login
124
+ growthub auth whoami
125
+ ```
103
126
 
104
- ## Extension Model
127
+ </details>
105
128
 
106
- Content extensions:
129
+ ## Immediate value first, activation optional
107
130
 
108
- - worker kits: `cli/assets/worker-kits/`
109
- - shared templates: `cli/assets/shared-templates/`
131
+ You can get real local value without connecting a hosted account.
110
132
 
111
- Governance/reference docs:
133
+ When ready, activate deeper hosted lanes:
112
134
 
113
- - [Worker Kits](../docs/WORKER_KITS.md)
114
- - [CLI Workflows Discovery V1](../docs/CLI_WORKFLOWS_DISCOVERY_V1.md)
115
- - [Agent Harness Auth Primitive](../docs/AGENT_HARNESS_AUTH_PRIMITIVE.md)
116
- - [Kernel Packet Registry](../docs/kernel-packets/README.md)
135
+ [![Activate on Growthub](https://img.shields.io/badge/Activate-Growthub-111827?style=for-the-badge)](https://www.growthub.ai/)
136
+ [![First Month](https://img.shields.io/badge/First%20Month-%241-22c55e?style=for-the-badge)](https://www.growthub.ai/)
117
137
 
118
- ## Links
138
+ ## Docs
119
139
 
120
- - [Growthub Local Repository](https://github.com/Growthub-ai/growthub-local)
121
- - [Root README](https://github.com/Growthub-ai/growthub-local#readme)
140
+ - [Growthub Local README](https://github.com/Growthub-ai/growthub-local#readme)
141
+ - [Worker Kits](https://github.com/Growthub-ai/growthub-local/blob/main/docs/WORKER_KITS.md)
142
+ - [CLI Workflows Discovery](https://github.com/Growthub-ai/growthub-local/blob/main/docs/CLI_WORKFLOWS_DISCOVERY_V1.md)
143
+ - [Agent Harness Auth Primitive](https://github.com/Growthub-ai/growthub-local/blob/main/docs/AGENT_HARNESS_AUTH_PRIMITIVE.md)
122
144
  - [Contributing](https://github.com/Growthub-ai/growthub-local/blob/main/CONTRIBUTING.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@growthub/cli",
3
- "version": "0.7.3",
3
+ "version": "0.7.4",
4
4
  "description": "Growthub Local is a control plane for forked worker kits. The CLI is the executor, the hosted app is the identity authority, the worker kit is the unit of portable agent infrastructure, and the fork is the operator's personal branch of that infrastructure — policy-governed, trace-backed, and self-healing.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -34,6 +34,11 @@
34
34
  "scripts": {
35
35
  "pack:dry-run": "npm pack --dry-run"
36
36
  },
37
+ "devDependencies": {
38
+ "@types/node": "^24.6.0",
39
+ "typescript": "^5.7.3",
40
+ "vitest": "^3.0.5"
41
+ },
37
42
  "dependencies": {
38
43
  "@aws-sdk/client-s3": "^3.888.0",
39
44
  "@clack/prompts": "^0.10.0",