README

Interactive CLI wizard that scaffolds a new PHP repo against the canonical Sander / hihaho baseline defined by sandermuller/repo-init. Same UX as laravel new — pick a category, answer a few questions, and get a repo with Composer dependencies installed, CI and quality tooling wired up, AI tooling synced, and composer test green on the first run.

Install (one-time per machine)

composer global require sandermuller/repo-new

Make sure your global Composer bin directory (~/.composer/vendor/bin or ~/.config/composer/vendor/bin) is on your PATH. sandermuller/repo-init — the source of the stubs and dependency lists — is pulled in automatically as a dependency; no separate install needed.

On first run, repo syncs its bundled AI skills to your user scope (~/.claude/skills/, ~/.codex/skills/, etc.) so they're available to every agent on the machine — no manual boost sync --scope=user step needed. Subsequent runs no-op via a per-version sentinel. Set BOOST_SKIP_AUTOSYNC=1 to disable.

Use

Interactive (recommended) — the wizard walks you through every choice:

repo new

Non-interactive (CI / scripting) — supply choices as flags:

repo new my-laravel-app \
  --type=laravel-project \
  --vendor=acme \
  --description="My new Laravel app" \
  --php=8.4 \
  --test-framework=phpunit

See repo new --help for the full flag list.

Categories

repo-new scaffolds seven repo categories. Choose one interactively, or pass --type:

What it sets up

Beyond the category-specific source skeleton above, every scaffolded repo gets the same baseline:

• Project files — composer.json with PSR-4 autoloading, src/ + tests/, plus README.md, CHANGELOG.md, LICENSE, SECURITY.md, .editorconfig, .gitignore, .gitattributes (lean published archive), and .mcp.json.
• CI workflows — GitHub Actions for the test suite, PHPStan, Pint, Rector, and changelog automation, plus a Dependabot config.
• Quality tooling, configured and installed — Pint (pint.json), PHPStan (phpstan-baseline.neon) with the strict / deprecation / PHPUnit / disallowed-calls / Symplify extension set, Rector with type-perfect, and type-coverage + cognitive-complexity analysis. All wired into composer scripts.
• Test suite — Pest or PHPUnit. PHPStan / Rector extensions and Laravel projects default to PHPUnit; other categories default to Pest (PHPUnit for the hihaho vendor). Override with --test-framework.
• AI tooling — sandermuller/package-boost-php + boost-core installed and a .config/boost.php config scaffolded — the agents, dependency vendors, and sandermuller/boost-skills capability tags to sync (tags chosen interactively or via --skill-tags; package categories only — laravel-project uses laravel/boost instead). Then vendor/bin/boost sync generates .ai/, .claude/, .agents/, .cursor/, AGENTS.md, CLAUDE.md, and the per-agent skill directories.

Per-category runtime and dev dependencies come from repo-init's references/per-category-deps.yml, so the dependency set always matches the current canonical baseline.

skill-bundle is the lean exception: it ships pure-markdown skills with no PHP, so it skips the PHP toolchain (PHPStan, Rector, PHPUnit, .mcp.json, the phpstan / rector-check workflows) and the test runner — keeping Pint, lean-package-validator, the meta files, and the pint-check + update-changelog workflows.

How it works

1. The wizard collects: category → vendor → package name → description → PHP version → (Laravel constraint for laravel-package, plugin shape for composer-plugin) → test framework → boost-skills tags → opt-ins.
2. Runs laravel new --boost (for laravel-project) or copies the category stubs (for package categories) from the installed repo-init.
3. Substitutes placeholders (__VENDOR__, __NAMESPACE__, __PACKAGE_STUDLY__, …) across composer.json, source files, and CI workflows.
4. Pre-allows Composer plugins (phpstan/extension-installer, pestphp/pest-plugin) before requiring dependencies, so install never aborts on the plugin allowlist.
5. Runs composer install and the per-category composer require lists.
6. Fires vendor/bin/boost sync to generate the AI tooling files.
7. Initializes a git repo (add --commit for an initial commit) and prints a copy-pasteable handoff prompt for Claude or your agent of choice.

Testing

composer test

Changelog

See CHANGELOG.md and releases.

Security

See SECURITY.md.

License

MIT — see LICENSE.