Changelog

All notable changes to this project are recorded here.

The format follows Keep a Changelog, and this project follows Semantic Versioning.

Unreleased

2.3.1 - 2026-09-10

Fixed

• A correct --if-match value was silently altered before it reached the server, so a working request failed with a confusing validation error instead of succeeding. The CLI auto-decodes an argument that looks like JSON, and a strong ETag is quoted by definition ("abc123") — that auto-decoding stripped the required quotes, and the server then rejected the header as malformed. --if-match and --idempotency-key now always transmit exactly as typed; a --body field or other request field still decodes JSON as before.

2.3.0 - 2026-09-01

Syncs the CLI against Subscribr's contract as deployed to production on 2026-08-31: the Video slice is now fully live, and the customer API grew past video for the first time.

Added

• video replace-with-media, staging the replacement of a visual block with an image from the Team's own media library (videoReplaceWithMedia, video:edit, idempotency and concurrency both required, same as every other Review & Fix staging write). The image must be at least the video's canvas size or the request is rejected. Replacing a real-photo block spends a credit; replacing a studio slide, illustration, or stock block is free.
• Seven thumbnails board commands the API contract now exposes: thumbnails get-thumbnail-board, add-thumbnail-board-images, create-thumbnail-board-generation, edit-thumbnail-board-image, set-thumbnail-board-text, export-thumbnail-board-image, and assign-thumbnail-board-image-to-script.
• The Review & Fix loop in the CLI addendum now tells an agent to check edit_availability (can_start_new_pass, can_apply, edit_window_ends_at) from video get-editable-content before starting a new pass and again before calling apply-revision — a customer normally gets one revision round, and applying spends it.

Changed

• Retired the "may not be deployed yet" explanation for a bare 404 on a Review & Fix, apply-revision, or generation operation. Main deployed the whole Video slice to production on 2026-08-31, so a bare 404 on any video operation now means an ordinary not-found, the same as everywhere else in the API. video_capability_unavailable and video_provisioning_required are unaffected — those are real, per-Team gates, not a deploy-status signal. Removed VIDEO_OPERATIONS_PENDING_DEPLOY and its special-case handling in request().
• scripts/verify_package.py's Video guard now recognizes videoReplaceWithMedia as an ordinary edit-shaped staging write.

2.2.0 - 2026-08-28

Ships as @subscribrai/cli. Adds the Subscribr Video Review & Fix surface — reads, staging writes, and publish — plus generation (quote/create/cancel) and a generic file-download convenience.

Added

• Subscribr Video project and revision reads: video list-projects, video get-project, video get-project-download, video get-editable-content, video get-revision-manifest, video list-overlay-templates, video get-quality-report, and video get-revision-pass.
• Subscribr Video revision-staging and discard writes, each requiring --idempotency-key and --if-match: video add-overlay, video remove-staged-overlay, video update-overlay, video remove-overlay, video update-captions, video remove-music, video edit-slide-text, video regenerate-visual, video show-presenter, and video discard-edit. A 409 revision_conflict on any of them returns error.current_revision; retry the identical write with that value as the new --if-match.
• video apply-revision, which publishes the staged changes as a new, immutable video revision. Requires the video:publish ability (staging writes require video:edit); confirm with the user before calling it, then poll the returned operation with operations get-operation.
• --output <path>, for any command whose response carries a download_url (for example video get-project-download). Streams the file straight to disk instead of printing the signed URL, and never sends your bearer token to the signed URL's own host.
• video quote-video, video create-video, and video cancel-video, for generating a new video. quote-video returns required_credits and spends nothing, so an agent can price a generation before committing to it; quote and charge always agree. create-video requires --idempotency-key, so a replayed submit converges on the same video instead of billing twice, and returns 202 with an operation to poll with operations get-operation, the same as apply-revision. cancel-video works at any point before the video finishes, is a harmless no-op once it has, and refunds the full charge. All three require the video:generate ability, separate from video:edit/video:publish — a token can edit and publish without ever being able to spend.
• A 404 on any of the 22 operations above that carries no typed Subscribr error body now explains itself: the operation may not be deployed or enabled for this Team yet, rather than a generic validation failure. A disabled-but-deployed capability still returns the typed video_capability_unavailable error, unchanged; a genuine not-found on a deployed route is also typed and is not affected. README.md and the skill's CLI addendum both say so up front.

Changed

• Renamed the Claude Code plugin from subscribr to subscribr-cli, and adopted the official plugin manifest schema. The Subscribr app publishes a separate subscribr plugin for its hosted MCP connector, and the two names collided. This one is the CLI and its API skill; that one is the MCP connector. The npm package is unaffected, because the plugin manifests do not ship in it.
• scripts/verify_package.py's Video guard no longer checks the surface against a frozen list of nine read operations. It now enforces five shapes instead: a read must be GET, require only video:read, and carry no write safety; a staging or discard write must require video:edit with both idempotency and concurrency; apply-revision must require video:publish with the same write safety; quote-video must require video:generate with idempotency and concurrency both unsupported; and create-video/cancel-video must require video:generate with idempotency required and concurrency unsupported.

2.1.1 - 2026-08-27

The first release with a full public project setup. No behavior changed: the CLI, its commands, and its API surface are identical to 2.1.0.

Added

• AGENTS.md, so an AI agent working on this repository finds the test commands and the generated-file rule in the standard place.
• CONTRIBUTING.md and SECURITY.md.
• CHANGELOG.md, starting with this release.
• CLI-REFERENCE.md, holding the request conventions, exit codes, retry and idempotency model, and the contract regeneration steps.
• A Claude Code plugin manifest, at .claude-plugin/. You can now install the skill with /plugin marketplace add https://github.com/SubscribrAI/cli, as an alternative to the npm path. A test keeps its version in step with the other manifests. (Renamed to subscribr-cli in 2.2.0.)
• Documentation for the thumbnails domain, which the CLI has always shipped but never described.
• npm version and license badges in the README.

Changed

• Rewrote README.md for a reader who has never used Subscribr. It now explains the product first, lists what you can do with the CLI, and moves the deep technical material to CLI-REFERENCE.md.
• Updated the positioning to match Subscribr today: one YouTube content engine covering research, ideas, thumbnails, scripts, and video, usable by a person or by an AI agent on the same plan.
• Pointed the repository metadata at github.com/SubscribrAI/cli.

2.1.0 - 2026-08-27

The first release under the @subscribrai scope.

Changed

• Renamed the package from @giltotherescue/subscribr-cli to @subscribrai/cli. The command names subscribr, subscribr-cli, and subscribr-install-skill are unchanged.
• Deprecated every version of @giltotherescue/subscribr-cli on npm, with a notice pointing at the new name.