About cli-anything-live2d
cli-anything-live2d is a command-line toolkit for inspecting, editing, validating, and packaging Live2D Cubism models without the Live2D Editor. It serves model creators and asset workflows with commands for analysis, batch changes, generation, and deployment preparation.
Key features
- 01Inspect model structure and assets
- 02Edit motions, expressions, and textures
- 03Lint and check runtime compatibility
- 04Batch-edit models and track changes
- 05Generate templates and package assets
Use cases
- 01Review a model's files and dependencies
- 02Apply edits across multiple models
- 03Prepare model assets for deployment
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/cli-anything-live2din Claude Code to confirm it loaded.
Details
From the project READMEcli-anything-live2d
Full-featured CLI for Live2D Cubism models. 42 commands covering inspection, editing, linting, diffing, batch operations, asset management, generation, and deployment — all without the Live2D Editor.
Commands (42 total)
Read (18)
| Command | Purpose |
|---|---|
inspect <model> | Model overview (version, counts, features) |
validate <model> | Check all referenced files exist |
motions <model> | List motions with fade times |
motion-info <file> | Detailed motion analysis |
expressions <model> | List expression presets |
expr-info <file> | Detailed expression analysis |
textures <model> | List textures with dimensions and sizes |
physics <file> | Physics simulation config |
moc3 <file> | Moc3 binary info |
params <model> | Parameter groups |
param-list <model> | All params across motions/expressions |
deps <model> | Dependency graph |
compare <a> <b> | Quick comparison |
diff <a> <b> | Detailed diff |
scan <dir> | Find all models in directory |
export <model> | Export as JSON/CSV |
stats <dir> | Project overview |
manifest <model> | File inventory with SHA256 checksums |
Edit (10, all auto-backup)
| Command | Purpose |
|---|---|
edit-motion | Edit motion fade times or file path |
add-motion | Add motion to group |
rm-motion | Remove motion |
add-expr | Add expression |
rm-expr | Remove expression |
edit-texture | Replace texture path |
edit-model | Edit moc3/physics/pose/userdata |
param-edit | Edit parameter value in .exp3.json |
rename-group | Rename a motion group |
find-replace | Batch rename file references |
Generation (3)
| Command | Purpose |
|---|---|
init | Generate full model template |
gen-motion | Generate skeleton .motion3.json |
gen-expr | Generate skeleton .exp3.json |
Analysis (4)
| Command | Purpose |
|---|---|
lint | Best practice checks |
runtime-check | Cubism Viewer / Web SDK / Yoyo compatibility |
atlas | Texture atlas analysis |
orphan | Find unreferenced files |
Workflow (7)
| Command | Purpose |
|---|---|
undo | Restore from auto-backup |
backup-clean | Rotate old backups |
restore-file | Restore specific file from backup |
batch | Batch-edit multiple models |
snapshot | Generate HTML preview |
watch | Auto-validate on file changes |
flatten | Flatten directory for deployment |
Other (3)
| Command | Purpose |
|---|---|
migrate | Model format version upgrade |
pack | Package model + deps into zip |
yoyo-check | Yoyo desktop-pet readiness |
All read commands support --json. Edit commands auto-backup.
Examples
cli-anything-live2d inspect model.model3.json
cli-anything-live2d lint model.model3.json --level info
cli-anything-live2d edit-motion model.model3.json -g Idle -i 0 --fade-in 0.3
cli-anything-live2d find-replace model.model3.json -f "old_tex" -f "new_tex"
cli-anything-live2d orphan model.model3.json
cli-anything-live2d runtime-check model.model3.json --target web-sdk
cli-anything-live2d flatten model.model3.json --out-dir ./deploy/
cli-anything-live2d batch ./models/ --set-fade-in 0.3 --dry-run
cli-anything-live2d snapshot model.model3.json --embed
cli-anything-live2d stats ./project/
Comments
Markdown supported