@anvil-works/anvil-cli 0.5.2 → 0.5.4

package/README.md

@@ -34,21 +34,22 @@ curl -fsSL https://anvil.works/install-cli.cmd -o install.cmd && install.cmd &&
 ### Manual Fallback
 
 ```bash
-npm install -g @anvil-works/anvil-cli
+npm install -g @anvil-works/anvil-cli@latest
 ```
 
 ## Quick Start
 
-### 1. Run Onboarding (Recommended First Step)
+### 1. Run Configure (Recommended First Step)
 
-Start with guided setup for your default server URL, login, and optional checkout:
+Start with guided setup for your default server URL and login:
 
 ```bash
-anvil onboard
+anvil configure
 ```
 
 When prompted for **Default Anvil server URL**, press Enter unless you're
 running a dedicated enterprise/on-prem Anvil installation.
+`anvil configure` does not run checkout automatically; it ends by suggesting `anvil checkout`.
 
 ### 2. Check Out Your App from the IDE URL
 
@@ -72,10 +73,11 @@ anvil watch
 
 -   `-A, --appid <APP_ID>` - Specify app ID directly
 -   `-f, --first` - Auto-select first detected app ID without confirmation
--   `-s, --staged-only` - Only sync staged changes (use `git add` to stage files)
--   `-a, --auto` - Auto mode: restart on branch changes and sync when behind
--   `-u, --url <ANVIL_URL>` - Specify Anvil server URL (e.g., `anvil.works`, `localhost:3000`)
--   `-V, --verbose` - Show detailed output
+-   `-s, --staged-only` - Only sync staged changes (use `git add` to stage files)
+-   `-a, --auto` - Auto mode: restart on branch changes and sync when behind
+-   `-O, --open` - Open watched path in your preferred editor (or default app)
+-   `-u, --url <ANVIL_URL>` - Specify Anvil server URL (e.g., `anvil.works`, `localhost:3000`)
+-   `-V, --verbose` - Show detailed output
 
 **Tip:** Open your app in the [Anvil IDE](https://anvil.works) to see your local changes appear in real-time. Changes made in the IDE will also sync back to your local files.
 
@@ -100,10 +102,11 @@ The diagram shows bidirectional sync:
 | Command                                | Description                                                          |
 | -------------------------------------- | -------------------------------------------------------------------- |
 | `anvil watch [path]`                   | Watch directory for changes and sync to Anvil                        |
+| `anvil watch [path] -O`                | Open watched path in preferred editor/default app                    |
 | `anvil watch -V` or `--verbose`        | Watch with verbose logging (detailed output)                         |
 | `anvil w [path]`                       | Short form for watch                                                 |
-| `anvil onboard`                        | Guided setup for default URL, login, and optional checkout           |
-| `anvil checkout <input> [directory]`   | Check out an Anvil app locally from editor URL, git URL, or app ID  |
+| `anvil configure`                      | Guided setup for default URL and login                               |
+| `anvil checkout [input] [directory]`   | Check out an app by URL/app ID, or interactively with no input       |
 | `anvil login [anvil-server-url]`       | Authenticate with Anvil using OAuth (supports smart URL handling)    |
 | `anvil l [anvil-server-url]`           | Short form for login                                                 |
 | `anvil logout [anvil-server-url]`      | Logout from Anvil (optionally specify URL for specific installation) |
@@ -160,7 +163,21 @@ anvil watch
 
 ### Checkout Apps
 
-`anvil checkout` accepts an editor URL, git URL, or bare app ID:
+`anvil checkout` accepts an editor URL, git URL, bare app ID, or no input for interactive selection:
+
+```bash
+# Interactive search/select (ordered by most recently edited)
+anvil checkout
+```
+
+In interactive mode, apps are displayed as `App Name (APPID)` and support:
+-   Arrow-key selection
+-   Auto-pagination (fetch-ahead with local cache)
+-   Search by app name or app ID
+
+In non-interactive mode, pass an explicit app input:
+-   `anvil checkout APPID`
+-   `anvil checkout https://anvil.works/git/APPID.git`
 
 ```bash
 # Checkout from editor URL
@@ -179,6 +196,14 @@ anvil checkout MHVELZG5SZXK2POE my-local-app --url anvil.works
 anvil checkout MHVELZG5SZXK2POE --branch master --depth 1 --single-branch
 anvil checkout MHVELZG5SZXK2POE --origin upstream
 anvil checkout MHVELZG5SZXK2POE --quiet
+
+# Seed interactive search query
+anvil checkout -Q "dashboard"
+anvil checkout --query "dashboard"
+
+# Open watched path in editor/default app
+anvil watch -O
+anvil watch ./my-app -O
 ```
 
 Safety behavior:
@@ -199,7 +224,7 @@ Checkout options:
 -   `--depth <N>` - Shallow clone with `N` commits of history
 -   `--single-branch` - Clone only one branch
 -   `--origin <NAME>` - Use custom remote name instead of `origin`
--   `-q, --quiet` - Suppress git clone progress output
+-   `--quiet` - Suppress git clone progress output
 -   `--verbose` - Verbose git clone output
 -   `-f, --force` - Override destination safety checks
 -   `-u, --url <ANVIL_URL>` - Override detected Anvil URL
@@ -296,7 +321,7 @@ anvil config set verbose true
 
 ### Preferred Editor
 
-Set this during `anvil onboard`.
+Set this during `anvil configure`.
 
 If needed later, you can still set it manually with:
 
@@ -305,6 +330,7 @@ anvil config set preferredEditor <editor>
 ```
 
 `preferredEditor` is used by checkout for post-checkout guidance and `-O/--open`.
+It is also used by `anvil watch -O`.
 
 Verbose output includes timestamped diagnostic lines with file routing details, sync status checks, and other internal processing information.