@geastack/cli 0.1.4 → 0.1.5

package/README.md

@@ -26,7 +26,7 @@ gea inspect --json
 
 ```mermaid
 flowchart TD
-  create["npx @geastack/create-geastack my-app"] --> identity["Resolve app identity<br/>argument, optional --id, optional --name"]
+  create["gea create my-app"] --> identity["Resolve app identity<br/>argument, optional --id, optional --name"]
   identity --> starter{"Starter app?"}
 
   starter -->|"Counter starter"| counter["Copy bundled minimal JSX counter"]

package/docs/ESP32-WAVESHARE-AMOLED-QUICKSTART.md

@@ -30,7 +30,8 @@ You do not clone GeaStack.
 
 ```sh
 npm login
-npx @geastack/create-geastack my-app
+npm install --global @geastack/cli
+gea create my-app
 cd my-app
 ```
 
@@ -45,12 +46,12 @@ When the wizard asks what to create, choose:
 
 For the fastest first flash, choose `Counter starter`.
 
-That creates a tiny JSX app with one store and installs the project-local Gea CLI, so inside the app you can run `npx gea`.
+That creates a tiny JSX app and installs all of its project dependencies.
 
 ## 3. Set Up The Board
 
 ```sh
-npx gea setup
+gea setup
 ```
 
 Choose:
@@ -82,7 +83,7 @@ If ESP-IDF was installed, the CLI prints this for future shells:
 . "$HOME/esp/esp-idf/export.sh"
 ```
 
-You do not need to run that before every command unless `npx gea doctor` says ESP-IDF is not active.
+You do not need to run that before every command unless `gea doctor` says ESP-IDF is not active.
 
 If the wizard finds a connected serial device, pick it. If no board is plugged in yet, that is fine; you can provide the port later.
 
@@ -93,13 +94,13 @@ The wizard writes the board config into your app at `.gea/boards.json` and initi
 Flash and open the serial monitor:
 
 ```sh
-npx gea flash --board amoled --monitor
+gea flash --board amoled --monitor
 ```
 
 If you need to specify the serial port manually:
 
 ```sh
-npx gea flash --board amoled --port /dev/cu.usbmodemXXXX --monitor
+gea flash --board amoled --port /dev/cu.usbmodemXXXX --monitor
 ```
 
 ## Rich Examples
@@ -109,10 +110,10 @@ The bundled starter is intentionally tiny. Rich examples live in the GeaStack ex
 For example:
 
 ```sh
-npx @geastack/create-geastack watch-demo --starter example --example watch
+gea create watch-demo --starter example --example watch
 cd watch-demo
-npx gea setup
-npx gea flash --board amoled --monitor
+gea setup
+gea flash --board amoled --monitor
 ```
 
 The CLI owns the example catalog, so the user does not need to clone the examples repo.
@@ -122,7 +123,7 @@ The CLI owns the example catalog, so the user does not need to clone the example
 Run:
 
 ```sh
-npx gea doctor
+gea doctor
 ```
 
 Most first-run issues are one of:

package/docs/SPEC.md

@@ -115,7 +115,7 @@ Minimum checks:
 Human-readable output should point to [SETUP.md](SETUP.md) whenever a required
 or optional dependency is missing.
 
-### `create-geastack`
+### `gea create`
 
 Scaffolds a new app folder with:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "description": "Command-line front door for GeaStack apps, targets, and local toolchains.",
   "publishConfig": {

package/src/create-geastack.mjs

@@ -15,6 +15,8 @@ import {
   formatStarterChoice
 } from './starter-catalog.mjs'
 
+const cliVersion = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version
+
 export async function runCreateGeastack(argv, io = {}) {
   const parsed = parseArgs(argv)
   const stdout = io.stdout || console.log
@@ -38,7 +40,7 @@ export async function runCreateGeastack(argv, io = {}) {
   const ctx = createContext(parsed, env, cwd)
   const displayName = option(parsed, 'name', titleFromId(appId))
   const coreDependency = option(parsed, 'core-dependency') || '^0.1.4'
-  const cliDependency = option(parsed, 'cli-dependency') || '^0.1.4'
+  const cliDependency = option(parsed, 'cli-dependency') || `^${cliVersion}`
   const starter = await resolveStarter(ctx, parsed, io)
   const entry = projectRelativePath(option(parsed, 'entry') || starter.starter?.entry || starter.example?.entry || 'index.tsx', 'entry')
   if (option(parsed, 'entry') && starter.kind !== 'empty') {