@docyrus/animaguru 0.14.0 → 0.16.0

package/README.md

@@ -89,7 +89,7 @@ Use a team ID returned by `workspaces list`. The choice is saved per server in t
 
 ## Agent workflow
 
-Remote projects are neutral containers. `projects create` has no `--style` flag. Choose a style when generating a sprite; local film setup keeps its separate style interview.
+Remote projects have no art style. `projects create` takes a name only. Choose the style for each sprite with `generate --style` or `files import --style` (hd-cartoon when left out); local film setup keeps its separate style interview.
 
 ```sh
 animaguru projects create --name "Forest cast"
@@ -102,7 +102,7 @@ animaguru files list PROJECT_ID
 animaguru files export PROJECT_ID --output forest-cast.zip
 ```
 
-`jobs wait` waits for the specified job only. A drawing may queue follow-up animation jobs; inspect `jobs list` and wait for those before exporting. Jobs continue on the server if the CLI exits. `files export` refuses to overwrite a file. `projects rename PROJECT_ID --name "New name"` and `projects delete PROJECT_ID --yes` manage the library. `models PROJECT_ID --image-model gpt-image-2.5 --video-model heygen/heygen-video-1` sets the defaults for future jobs. The previous `--model` option remains an alias for `--image-model`.
+`jobs wait` waits for the specified job only. A drawing may queue follow-up animation jobs; inspect `jobs list` and wait for those before exporting. Jobs continue on the server if the CLI exits. `files export` refuses to overwrite a file. `projects rename PROJECT_ID --name "New name"` and `projects delete PROJECT_ID --yes` manage the library. `projects move PROJECT_ID --to OTHER_PROJECT_ID --characters SLUG,SLUG --assets ASSET_ID --avatars GROUP_ID` moves characters (with all their animations), saved assets and the project's own avatars to another project you can write to, without regenerating anything (CLI 0.16.0). `models PROJECT_ID --image-model gpt-image-2.5 --video-model heygen/heygen-video-1` sets the defaults for future jobs. The previous `--model` option remains an alias for `--image-model`.
 
 Generation and reference imports require `--yes`, which authorizes credit spending. Read estimates from `projects get` before submitting. Estimates are ranges; actual provider usage is recorded to your own balance. Paid generation needs configured production provider bindings and secrets.
 
@@ -313,7 +313,7 @@ Custom motions require 2–12 frame descriptions, a 20–600 character prompt, a
 Reference images:
 
 ```sh
-animaguru files import PROJECT_ID --file knight.png --name Knight --description "Keep the blue armor" --yes
+animaguru files import PROJECT_ID --file knight.png --name Knight --style pixel --description "Keep the blue armor" --yes
 ```
 
 PNG, JPEG and WebP are accepted up to 10 MB. A configured service redraws the reference and charges credits; otherwise it imports the original artwork.
@@ -339,6 +339,21 @@ animaguru motion get skeleton-list-swipe --write animations/launch/src/scenes
 
 Then call the entry function from `Film.build()`, for example `skeletonListSwipe(this, { at: 4 })`. `--write` refuses to replace an existing scene (pass `--force`) and keeps shared modules that already exist.
 
+## Asset library
+
+CLI 0.15.0 adds `animaguru library`. Pro and Team accounts (and members of a team on the Team plan) can search AnimaGuru's asset library: ready-made sprites with animation sheets, images, video clips, music, voice-over speech and sound effects. Search uses natural language and keywords together. Importing into a project or downloading spends no credits, so check the library before generating a common asset.
+
+```sh
+animaguru library types                                   # types, counts, and whether this account has access
+animaguru library search whoosh for a scene transition --type sfx
+animaguru library search upbeat piano background --labels corporate --limit 3
+animaguru library get pixel-knight                        # description, details (length, size, frames) and files
+animaguru library import pixel-knight --project PROJECT_ID  # sprites become characters, media become saved assets
+animaguru library download mountain-lake-sunrise --output assets/   # saves ID.EXT; sprites save ID/ with sheets and animation.json
+```
+
+An imported image, clip or audio file appears in `assets list` with its file SHA, so it can start an image-to-video generation or be a soundtrack. A sprite's `animation.json` lists frame rectangles `[x, y, w, h]`, per-frame durations, fps, loop and pivot. Staff publish entries with `animaguru library publish --project ID (--asset ASSET_ID | --character SLUG) --title … --summary … --description … --labels …`, and edit or remove them with `library update` and `library remove --yes`.
+
 ## Submit and share videos
 
 Run `animaguru auth login`, then submit from a finished AnimaGuru video workspace: