@anvil-works/anvil-cli 0.3.10 → 0.3.12

package/README.md

@@ -70,18 +70,12 @@ anvil login https://anvil.works
 
 **Multiple Accounts:** anvil-cli supports multiple Anvil installations simultaneously. Each URL has its own authentication tokens, so you can work with different enterprise installations or switch between them easily.
 
-### 2. Sync Your Changes
+### 2. Watch Your Changes
 
-Navigate to your local Anvil app directory and start syncing:
+Navigate to your local Anvil app directory and start watching:
 
 ```bash
 cd /path/to/your/anvil/app
-anvil sync
-```
-
-Or use the `watch` alias (for backward compatibility):
-
-```bash
 anvil watch
 ```
 
@@ -91,13 +85,15 @@ Or use the short form:
 anvil w
 ```
 
+> **Note:** `anvil sync` still works but is deprecated. Use `anvil watch` instead.
+
 You can specify the app ID explicitly:
 
 ```bash
-anvil sync -A YOUR_APP_ID
+anvil watch -A YOUR_APP_ID
 ```
 
-**Sync Options:**
+**Watch Options:**
 
 -   `-A, --appid <APP_ID>` - Specify app ID directly
 -   `-f, --first` - Auto-select first detected app ID without confirmation
@@ -128,10 +124,10 @@ The diagram shows bidirectional sync:
 
 | Command                                | Description                                                          |
 | -------------------------------------- | -------------------------------------------------------------------- |
-| `anvil sync [path]`                    | Watch directory for changes and sync to Anvil                        |
-| `anvil sync -V` or `--verbose`         | Sync with verbose logging (detailed output)                          |
-| `anvil watch [path]`                   | Alias for sync (backward compatibility)                              |
-| `anvil w [path]`                       | Short form for sync                                                  |
+| `anvil watch [path]`                   | Watch directory for changes and sync to Anvil                        |
+| `anvil watch -V` or `--verbose`        | Watch with verbose logging (detailed output)                         |
+| `anvil sync [path]`                    | Deprecated alias for `watch`                                         |
+| `anvil w [path]`                       | Short form for watch                                                 |
 | `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) |
@@ -152,7 +148,7 @@ anvil-cli can auto-detect your app ID using multiple strategies:
 If auto-detection fails, you can specify the app ID explicitly:
 
 ```bash
-anvil sync -A YOUR_APP_ID
+anvil watch -A YOUR_APP_ID
 ```
 
 ### Anvil URL Detection
@@ -169,15 +165,15 @@ anvil-cli automatically detects which Anvil server to use:
 
 ```bash
 # Auto-detect from git remote
-anvil sync
+anvil watch
 
 # Specify URL explicitly
-anvil sync --url anvil.works
-anvil sync --url localhost:3000
-anvil sync --url anvil.mycompany.com
+anvil watch --url anvil.works
+anvil watch --url localhost:3000
+anvil watch --url anvil.mycompany.com
 
 # If multiple accounts, you'll be prompted to select
-anvil sync
+anvil watch
 # ? Multiple Anvil installations found. Which one would you like to use?
 # ❯ https://anvil.works
 #   https://anvil.company.com
@@ -224,7 +220,7 @@ By default, anvil-cli shows minimal output. For more detailed logging:
 **One-time:** Use the `-V` or `--verbose` flag:
 
 ```bash
-anvil sync --verbose
+anvil watch --verbose
 ```
 
 **Persistent:** Set verbose mode in config:
@@ -253,7 +249,7 @@ anvil login https://anvil.mycompany.com
 
 ```bash
 # Sync with specific URL
-anvil sync --url anvil.mycompany.com
+anvil watch --url anvil.mycompany.com
 ```
 
 **Option 3: Set global default**
@@ -275,7 +271,7 @@ anvil login anvil.company-b.com
 
 # When syncing, you'll be prompted to select which one to use
 # Or specify explicitly:
-anvil sync --url anvil.company-a.com
+anvil watch --url anvil.company-a.com
 ```
 
 **URL Resolution Priority:**
@@ -324,8 +320,8 @@ anvil logout --url localhost:3000
 
 -   Ensure you're in an Anvil app directory with `anvil.yaml`
 -   Check git remotes: `git remote -v`
--   Specify app ID explicitly: `anvil sync -A YOUR_APP_ID`
--   Use `-f, --first` to auto-select the first detected app ID: `anvil sync -f`
+-   Specify app ID explicitly: `anvil watch -A YOUR_APP_ID`
+-   Use `-f, --first` to auto-select the first detected app ID: `anvil watch -f`
 
 ### "Authentication failed" or "Not logged in to [URL]"