cli-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/