craft-cli 0.6.0: local media workflows
craft-cli can now resolve full-resolution Craft media on your Mac, analyze local files without downloading them again, and safely replace media through the Craft API.
craft-cli 0.6.0 is out. Release on GitHub.
Craft keeps downloaded images, videos, and files in an on-device cache. craft-cli can now resolve those assets to their existing local paths:
craft media local <blockId>
craft media local <blockId> --all --jsonThe path is useful for inspection, transcription, metadata extraction, and other local analysis. Craft owns the cached file, so copy it before editing.
Analyze and replace
craft media analyze <blockId>
craft media replace <blockId> edited.mov --content-type video/quicktimeMedia analysis now prefers the full local asset and falls back to Craft’s signed URL when it is not available on-device.
Replacement uploads the new file beside the existing media block, verifies its type and URL, and only then deletes the old block. The replacement receives a new block ID. Blocks with children or comments are left untouched so linked context is not silently lost.
The release also aligns public block types and retry behavior with the current Craft API documentation, including page styling, separator fields, documented rate budgets, and jittered retry backoff.
Upgrade
cd ~/dev/tools/craft-cli
git pull
./install.sh
craft media local <blockId>