@growthub/create-growthub-local

@growthub/create-growthub-local is the guided installer for Growthub Local.

It creates a governed Workspace — the top-level Growthub product object and Agent Workspace as Code (AWaC) artifact — by exporting the official growthub-custom-workspace-starter-v1 kit and pinning the matching @growthub/cli version. Local value first; hosted authority is additive.

Quickstart

npm create @growthub/growthub-local@latest

After install, open the no-code Workspace Builder:

cd <workspace>/apps/workspace
npm install
npm run dev

Reference contracts:

• Workspace Config Contract V1
• Governed Workspace Topology V1
• Workspace Builder Runtime V1

Profile-first install

The installer offers profile selection before command/harness depth:

npm create @growthub/growthub-local@latest -- --profile gtm
npm create @growthub/growthub-local@latest -- --profile dx
npm create @growthub/growthub-local@latest -- --profile workspace --out ./my-workspace

How this fits the governed workspace architecture

The installer is the safest entrypoint into the same lifecycle the CLI operates:

1. choose a source profile or starter path
2. export the governed Workspace app
3. register the fork metadata and local policy
4. open the Workspace Builder for dashboards, tabs, widgets, templates, data model objects, and settings
5. continue with @growthub/cli for status checks, fork sync, deploy preparation, worker kits, workflows, pipelines, and optional Growthub authority

The generated Workspace is not a loose app copy. It carries growthub.config.json plus .growthub-fork/ lifecycle state so export, fork safety, ongoing customization, and agent operation stay tied to one portable artifact.

First-run outcomes

After install, users land on Custom AI Governed Workspace first. The fastest paths are:

1. import a GitHub repo into a governed workspace
2. import a skills.sh skill into a governed workspace
3. start from the workspace starter
4. start from a worker kit
5. connect Growthub account after local value is proven
6. 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 run

Optional upgrade activation

Local value comes first. Activation is optional and additive:

Requirements

• Node.js 20+
• npm 7+

Links

• Growthub Local README
• @growthub/cli package docs
• Contributing