Factory / Registry CLI

A Node.js CLI to scaffold new connectors and pipelines from the repository's JSON scaffold templates.

Install

From npm (recommended)

Install globally:

npm install -g @514labs/registry

Or use with npx (no installation required):

npx @514labs/registry --help

Local development (in this monorepo)

pnpm -C packages/factory-cli install
pnpm -C packages/factory-cli build

Optionally link the binary:

pnpm -C packages/factory-cli link --global

Usage

Using the installed CLI

• Show help:

registry --help

• Scaffold connector/pipeline metadata only:

registry scaffold connector meta \
  --name hubspot \
  --scaffold-version v3 \
  --author 514-labs \
  --yes

• Scaffold TypeScript implementation (connector example):

registry scaffold connector typescript \
  --name hubspot \
  --scaffold-version v3 \
  --author 514-labs \
  --implementation default \
  --package-name @workspace/connector-hubspot \
  --resource contacts \
  --yes

• Dry run without writing files:

registry scaffold pipeline typescript \
  --name google-analytics-to-clickhouse \
  --scaffold-version v1 \
  --author 514-labs \
  --dry-run \
  --yes

Using npx (no installation)

Replace registry with npx @514labs/registry in any of the above commands:

npx @514labs/registry --help
npx @514labs/registry scaffold connector meta --name example --yes

Local development

For local development in this monorepo, use the direct path:

node packages/factory-cli/dist/index.js --help

Notes

• The CLI auto-detects the repo root from the current working directory.
• Variables are validated against patterns defined in the scaffold JSON.
• Placeholders like {connector}, {pipeline}, {author}, {version} are replaced in paths and templates.