voxflow 1.13.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -103,10 +103,11 @@ echo "Hello world" | voxflow narrate
103
103
 
104
104
  ### `voxflow voices [options]`
105
105
 
106
- Browse and filter available TTS voices (no login required).
106
+ Browse and filter available TTS voices. The default catalog query is public (no login required); `--mine` switches to your **cloned voices** (login required, since 1.12.0).
107
107
 
108
108
  ```bash
109
- voxflow voices
109
+ voxflow voices # public catalog
110
+ voxflow voices --mine # YOUR cloned voices (since 1.12.0)
110
111
  voxflow voices --search "温柔" --gender female
111
112
  voxflow voices --language en --extended
112
113
  voxflow voices --json
@@ -114,6 +115,7 @@ voxflow voices --json
114
115
 
115
116
  | Flag | Default | Description |
116
117
  |------|---------|-------------|
118
+ | `--mine` | `false` | List your cloned voices via `/api/voice/list` (requires login) |
117
119
  | `--search <query>` | | Search by name, tone, style |
118
120
  | `--gender <m\|f>` | | Filter by gender |
119
121
  | `--language <code>` | | Filter by language: zh, en, etc. |
@@ -431,6 +433,39 @@ voxflow status # Show login status and token info
431
433
  voxflow dashboard # Open Web dashboard in browser
432
434
  ```
433
435
 
436
+ ### `voxflow upgrade [options]` *(since 1.12.0)*
437
+
438
+ One-shot self-update. Auto-detects your package manager (npm / pnpm / yarn / bun) and refreshes bundled skills so SKILL.md files stay in sync with the CLI binary.
439
+
440
+ ```bash
441
+ voxflow upgrade --check # only report whether a newer version exists
442
+ voxflow upgrade # interactive upgrade (prompts)
443
+ voxflow upgrade -y # non-interactive (for agents / CI / Skills)
444
+ voxflow upgrade --dry-run # print what would run
445
+ voxflow upgrade --version 1.13.0 # install a specific version
446
+ voxflow upgrade --no-skills # skip post-install skills sync
447
+ voxflow upgrade --force # reinstall even if already on latest
448
+ ```
449
+
450
+ | Flag | Description |
451
+ |------|-------------|
452
+ | `-y`, `--yes` | Skip the confirmation prompt |
453
+ | `--check` | Report version skew without installing |
454
+ | `--dry-run` | Print the install command instead of running it |
455
+ | `--force` | Reinstall even when already on the latest version |
456
+ | `--no-skills` | Skip the post-install `voxflow skills install --all` |
457
+ | `--version <ver>` | Install a specific version (e.g. `1.13.0`) |
458
+
459
+ Override the auto-detected package manager with `VOXFLOW_UPGRADE_PM=npm` (or `pnpm` / `yarn` / `bun`).
460
+
461
+ **Update-notifier hint** (since 1.11.5, structured since 1.14.0): every CLI invocation does a non-blocking 24h-cached check against the npm registry. When a newer version exists, an agent-readable line is emitted on stderr:
462
+
463
+ ```
464
+ <voxflow-hint v="1" type="cli-outdated" current="1.10.21" latest="1.14.0" action="voxflow upgrade -y" />
465
+ ```
466
+
467
+ Human users see a dim grey `▲ voxflow X → Y available` instead. Opt out with `NO_UPDATE_NOTIFIER=1` or `VOXFLOW_NO_UPDATE_CHECK=1`.
468
+
434
469
  ### `voxflow add <name>` *(experimental — Day-1 MVP)*
435
470
 
436
471
  Pull a curated flow / voice recipe / CLI preset from the official registry into your current project.