@growthub/create-growthub-local
v0.5.2
Published
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
Downloads
5,550
Maintainers
Readme
@growthub/create-growthub-local
@growthub/create-growthub-local is the guided installer for Growthub Local.
It is designed for immediate value first: choose a profile, create a usable local environment, then optionally activate hosted lanes later.
Quickstart
npm create growthub-local@latestProfile-first install
The installer offers profile selection before command/harness depth:
npm create growthub-local@latest -- --profile gtm
npm create growthub-local@latest -- --profile dx
npm create growthub-local@latest -- --profile workspace --out ./my-workspaceFirst-run outcomes
After install, users land on Create Governed Workspace first. The fastest paths are:
- import a GitHub repo into a governed workspace
- import a skills.sh skill into a governed workspace
- start a greenfield governed workspace
- start from a worker kit
- connect Growthub account after local value is proven
- optionally activate upgrade path for hosted depth
Installer options
| Flag | Applies to | Description |
|---|---|---|
| --profile gtm\|dx\|workspace | all | Pick an install profile |
| --run | dx, gtm, discovery | Start Growthub immediately after config |
| --data-dir <path> | dx, gtm, discovery | Override install directory (default: ./growthub-local) |
| --config <path> | dx, gtm, discovery | Use a custom config path |
| --out <path> | workspace | Destination for workspace scaffold |
| --kit <kit-id> | workspace | Source kit id (default: growthub-custom-workspace-starter-v1) |
| --name <label> | workspace | Human label for fork registration |
| --upstream <owner/repo> | workspace | Optionally create remote GitHub fork |
| --destination-org <org> | workspace | Create fork under org |
| --fork-name <name> | workspace | Override GitHub fork name |
| --remote-sync-mode <mode> | workspace | Initial policy mode: off, branch, pr |
| --json | workspace | Emit machine-readable output |
Post-install examples
# Re-open the CLI discovery hub
npx growthub discover
# Re-open the first-run governed workspace path
npx growthub discover --start create-workspace
# Run local app runtime
npx growthub runOptional upgrade activation
Local value comes first. Activation is optional and additive:
Requirements
- Node.js 20+
- npm 7+
