insifr-cli

Small CLI to clone the public insifr Founder Mode starter from GitHub and verify a checkout (doctor).

npm: this package publishes as @aphina/insifr-cli (npm user aphina). The default git clone URL still points at the rashadnazarli/insifr GitHub repo unless you override --repo or INSIFR_REPO.

Requirements

• Node.js 20+
• Git on your PATH (git --version)

Install (from this monorepo)

cd packages/insifr-cli
npm install
npm link   # optional: global `insifr` command for local dev

Usage

# Clone shallow (default) into ./insifr
insifr init

# Clone into a named folder
insifr init my-founder-workspace

# Full git history
insifr init my-workspace --no-shallow

# Custom repo (fork) or branch
insifr init --repo https://github.com/you/insifr-fork.git --branch main ./work

# Replace existing non-empty directory (destructive)
insifr init ./work --force

# After clone: verify layout
cd my-founder-workspace
insifr doctor .

Environment overrides

| Variable | Effect | |----------------|---------------------------------| | INSIFR_REPO | Default URL for --repo | | INSIFR_BRANCH| Default branch (also use -b) |

Troubleshooting

npx @aphina/insifr-cli@latest → 404 but npm view @aphina/insifr-cli version works

Clear the npx cache and pin a version:

rm -rf ~/.npm/_npx
npm cache clean --force
npx --yes @aphina/[email protected] init my-workspace

Target is not empty

The folder already exists (e.g. you ran init twice). Use a new directory name or insifr init <dir> --force (deletes the target first).

Publish to npm

Scoped names must match an npm user or org you control. The name field in package.json is @<npm-username>/<package> (run npm whoami). Publishing @rashadnazarli/... fails unless you create an npm org named rashadnazarli and have publish rights there.

npm login
npm publish --access public

Users can then run:

npx @aphina/insifr-cli@latest init my-workspace

(Replace @aphina with your scope if you rename the package.)

Commands

| Command | Description | |----------------|-------------| | insifr init | git clone from GitHub (default shallow, main) | | insifr doctor| Check required files exist |

License

MIT — see LICENSE.