create-zachflow
v1.7.0
Published
Bootstrap a new zachflow project (clone-and-strip).
Readme
create-zachflow
Bootstrap a new zachflow project. Zero runtime dependencies — uses only git and Node's built-in node:child_process/node:fs/node:path.
Usage
npx create-zachflow my-projectThis:
- Shallow-clones the zachflow repo to
my-project/at the tag matching this package's version ([email protected]→git clone --branch vX.Y.Z) - Strips development artifacts (
.git/,docs/superpowers/, etc.) - Re-initializes git with a fresh first commit
- Auto-runs
scripts/init-project.sh(the interactive wizard) when stdin is a TTY — one command, end-to-end setup.
In a non-TTY context (CI, redirected stdin) or with --no-init, the wizard is skipped and the manual next-step commands are printed instead.
Options
| Flag | Default | Description |
|------|---------|-------------|
| --repo=<url> | github.com/hx2ryu/zachflow.git | Repo URL |
| --branch=<name> | (none) | Branch to clone (e.g. main) |
| --tag=<tag> | v<pkg-version> | Tag to clone. Defaults to this package's version, so [email protected] clones zachflow at vX.Y.Z. |
| --no-init | (off) | Skip auto-running the wizard. Use for CI or when you want to inspect the project before initializing. |
| --help, -h | | Show help |
Env vars: ZACHFLOW_REPO_URL, ZACHFLOW_REF (overrides the default ref).
What gets stripped
The following are removed from the cloned repo:
.git/(replaced with fresh git init)docs/superpowers/(zachflow design history — for contributors).zachflow/(per-project state — wizard creates fresh)node_modules/,dist/,package-lock.json(regenerated)
What stays: workflows/, plugins/, scripts/, templates/, .claude/, schemas/, tests/, packages/, all root docs (README, MANUAL, ARCHITECTURE, CONTRIBUTING, CHANGELOG, LICENSE).
Alternative install paths
If you can't use npm directly:
- GitHub Release tarball (legacy bootstrap path, still maintained):
npx https://github.com/hx2ryu/zachflow/releases/download/vX.Y.Z/create-zachflow-X.Y.Z.tgz my-project --tag=vX.Y.Z - Repo clone:
git clone --depth 1 --branch vX.Y.Z https://github.com/hx2ryu/zachflow.git zachflow-template node zachflow-template/packages/create-zachflow/index.js my-project --tag=vX.Y.Z
License
MIT
