@astrale-os/cli 1.0.0-beta.1 → 1.0.0-beta.10

package/README.md

@@ -11,19 +11,15 @@ curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | sh
 ```
 
 The installer places a verified standalone binary at
-`~/.astrale/bin/astrale` by default. No local runtime is installed.
-
-During the prerelease period, install the current standalone beta explicitly:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | ASTRALE_CHANNEL=beta sh
-```
+`~/.astrale/bin/astrale` by default. No local runtime is installed. During the
+prerelease period, it follows the beta channel by default.
 
 Optional installer environment:
 
 ```bash
-ASTRALE_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | sh
-ASTRALE_VERSION=<version> curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | ASTRALE_INSTALL_DIR=/usr/local/bin sh
+curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | ASTRALE_CHANNEL=canary sh
+curl -fsSL https://raw.githubusercontent.com/astrale-os/cli/main/install.sh | ASTRALE_VERSION=<version> sh
 ```
 
 ### npm (CLI + Domain Studio)
@@ -105,8 +101,8 @@ astrale update --check
 astrale update
 ```
 
-`astrale update` upgrades official script installs. Use `--check`,
-`--channel <channel>`, or `--version <version>` to control the target release.
+`astrale update` upgrades official script installs and follows the beta channel by default.
+Use `--check`, `--channel <channel>`, or `--version <version>` to control the target release.
 
 ## Commands
 
@@ -131,7 +127,7 @@ Main command groups:
 
 ```
 /domain                        Domain node
-/domain/class.Name             Class node, or /domain/interface.Name
+/domain/class.Name             Class node
 /:domain:class.Name:method     Static method (semantic domain path)
 <nodePath>::method             Instance method dispatch
 @nodeId                        Reference a node by UID
@@ -166,3 +162,18 @@ bun cli/bin/astrale.ts <command>
 # Build the CLI
 pnpm -C cli build
 ```
+
+### Testing local changes live: `astrale-dev`
+
+When developing inside the [workspace](https://github.com/astrale-os/workspace),
+`astrale` stays the official released CLI. To run your local CLI source live
+(no build, no global link), use `astrale-dev`:
+
+```bash
+astrale-dev <command>   # execs `bun <workspace>/cli/bin/astrale.ts` of the
+                        # workspace/worktree you are currently in
+```
+
+It resolves the workspace from your current directory, so each worktree runs its
+own source, and outside a workspace it refuses (use `astrale`). It is installed
+by the workspace's `./scripts/init-machine.sh`.