Refactor/create command loose

[kfirstri]

Note

Description

This PR improves the base44 create command to be more agent-friendly by automatically inferring the project path from the project name when --path is not provided. It also improves error messaging and adds usage examples to the command's help text to make it easier to use programmatically or via AI agents.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

• Auto-infers --path from the project name argument (kebab-cased) when --path is omitted, enabling base44 create my-app to work without requiring an explicit path
• Adds log.info message at the start of non-interactive project creation to show the resolved path
• Improves the error message when --path is supplied without a project name, making it more actionable
• Adds usage examples to --help output for the create command
• Updates and adds tests to cover path inference and updated error message

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated docs/ (AGENTS.md) if I made architectural changes

Additional Notes

The path inference uses kebabCase(name) to normalize the project name into a filesystem-friendly directory name (e.g., "My App" → ./my-app).

---

_{🤖 Generated by Claude | 2026-03-11 00:00 UTC}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.44-pr.407.17e027d

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.0.44-pr.407.17e027d"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.44-pr.407.17e027d"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.0.44-pr.407.17e027d
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}