@decohere/create 0.0.1-dev.20261105.116 → 0.0.1-dev.20261105.119

package/README.md

@@ -6,11 +6,13 @@ Docker is required on the host. `@decohere/create` only pulls `ghcr.io/typesmith
 
 ## Usage
 
-`npm create` already says “create”, so the first token is the kind (`webapi`), not `create` again. The launcher forwards `decohere create webapi …` into the builder image.
+`npm create` already says “create”, so the first token is the kind (`webapi`), not `create` again. `webapi` is the only kind today, so you can leave it out and give just the project's folder. The launcher forwards `decohere create webapi …` into the builder image.
 
 This run prompts for database, auth, Postman, and whether to install:
 
 ```bash
+npm create @decohere@dev my-app
+# or
 npm create @decohere@dev webapi -d my-app
 # or
 npx @decohere/create@dev webapi -d my-app
@@ -26,7 +28,7 @@ npm create @decohere@dev -- webapi -d my-app --database postgres/typeorm --auth
 
 Target directory is `webapi`'s optional argument or `-d` (default `.`). `npm create` treats `-d` as its own loglevel flag and forwards `my-app` as a positional — that form is supported. Extra create flags still need `--` after `npm create`.
 
-The first token after the package must be a command (`webapi`); a bare directory name is an unknown command.
+A first token that isn't a command (`webapi`, `create`, `add`, `auth0`, `help`) or a flag is the project's folder, so a mistyped command starts a project with that name.
 
 The scaffolded Dev Container asks **y/N** (TTY only) before npm auth and optional codebase RAG MCP (semantic search). Decline or run without a TTY to skip. Credentials are written under the project `.cursor/` directory (gitignored).
 

package/es6/src/resolve-launch.js

@@ -3,25 +3,40 @@ const HOST_FLAGS_WITH_VALUE = new Set([
     "--config-file",
     "--log-level"
 ]);
+const PRODUCT_COMMANDS = new Set([
+    "create",
+    "add",
+    "auth0",
+    "help"
+]);
 /**
  * Map host / npm-create argv onto the product CLI (`create webapi` / `add api`).
  * `npm create @decohere webapi` already says “create”, so we prepend `create`
- * rather than making users type `create create webapi`.
+ * rather than making users type `create create webapi`. `webapi` is the only kind
+ * of project, so a first word that isn't a command is the project's folder.
  */ export function toProductArgv(tokens) {
-    if (tokens[0] === "webapi" && tokens[1] === "add") {
+    const [first] = tokens;
+    if (first === "webapi" && tokens[1] === "add") {
         return [
             "add",
             "api",
             ...tokens.slice(2)
         ];
     }
-    if (tokens[0] === "webapi") {
+    if (first === "webapi") {
         return [
             "create",
             "webapi",
             ...tokens.slice(1)
         ];
     }
+    if (first != null && !first.startsWith("-") && !PRODUCT_COMMANDS.has(first)) {
+        return [
+            "create",
+            "webapi",
+            ...tokens
+        ];
+    }
     return tokens;
 }
 export function containerArgvFromHost(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/create",
-  "version": "0.0.1-dev.20261105.116",
+  "version": "0.0.1-dev.20261105.119",
   "description": "Download the Decohere scaffolder image and run it (npm create @decohere)",
   "keywords": [
     "decohere",

package/types/src/resolve-launch.d.ts

@@ -8,7 +8,8 @@ export type LaunchPlan = {
 /**
  * Map host / npm-create argv onto the product CLI (`create webapi` / `add api`).
  * `npm create @decohere webapi` already says “create”, so we prepend `create`
- * rather than making users type `create create webapi`.
+ * rather than making users type `create create webapi`. `webapi` is the only kind
+ * of project, so a first word that isn't a command is the project's folder.
  */
 export declare function toProductArgv(tokens: string[]): string[];
 export declare function containerArgvFromHost(argv: string[]): string[];