nexmoe--vidbee/apps/cli/CHANGELOG.md

Changelog

All notable changes to @vidbee/cli are documented in this file.

The CLI follows Semantic Versioning, with versioning decoupled from VidBee Desktop. CLI bug-fixes and new yt-dlp probe-flag support ship on the CLI's own cadence; Desktop continues on 1.x.

[Unreleased]

[0.1.0] - 2026-05-02

First standalone release of @vidbee/cli. Tracks NEX-133 (CLI full-stack) and NEX-148 (standalone-only distribution).

Added

• argv parser that splits --vidbee-* flags + : subcommands from yt-dlp passthrough; unknown --vidbee-* tokens fail with exit 2 instead of being silently forwarded.
• Probe vs download mode detection covering every public yt-dlp probe-class flag and alias.
• :status, :download list/status/logs/cancel/pause/resume/retry, :history list/remove against the shared taskQueueContract.
• :version — prints CLI + contract version + changelog URL with no host contact.
• :upgrade — checks https://registry.npmjs.org/@vidbee/cli/latest, caches the result for 30 days, and prints install commands for npm / pnpm / bun / brew. Does not spawn npm install automatically.
• Three transports: Desktop loopback (with descriptor handshake + 1h token + autostart), --vidbee-api <url> (HTTPS required outside loopback / RFC1918), and --vidbee-local (in-process TaskQueueAPI + YtDlpExecutor, with optional SQLite for crash-recovery).
• dist/ bundle distributed via npm (pnpm publish) under @vidbee/cli. Tarball contains only dist/, README, CHANGELOG, LICENSE.
• Sensitive-argument redaction (--password, --video-password, --ap-password, --twofactor, Authorization: headers, URL token= / access_token= / signature= / policy= query strings).

Distribution

• Standalone npm publishing via cli-publish.yml, triggered by cli-v* tags.
• Shell installer at scripts/cli-install.sh — installs the npm tarball into ~/.vidbee/cli and writes a vidbee shim into ~/.local/bin.
• Homebrew tap (vidbee/homebrew-tap) tracked as a follow-up; the formula will wrap the same npm tarball.

Removed

• Bundling with VidBee Desktop. The Desktop installer no longer ships a CLI shim or rewrites your PATH. Install the CLI explicitly via npm / brew / shell installer. (NEX-148)