CLI reference

Installed binary: glina. In a checkout, replace glina with node pipeline/cli.js. Successful commands print JSON to stdout except help, or the same fields as path: value lines with --text; operational progress and refusals go to stderr. --help anywhere on the line prints help and runs nothing: the whole command table at the top level, and only that command's row after a command (glina doctor --help); both are rendered from one table in the CLI.

Argument parsing is intentionally small: --name value becomes a string, a flag without a following value becomes true, and remaining words are positional. Unknown options are ignored by commands that do not read them.

Command tree

• glina onboarding [--reset] [--asset <file.glb>] [--name <id>] — Run first use and optionally accept an existing GLB.
• glina import <file.glb> [--name <id>] [--variant-of <base-id>] [--config <path>] — Validate, persist, and activate a base asset or variant.
• glina workspace [list | select <id> | remove <id>] — Inspect imported assets, choose the active one, or take one out.
• glina help — Help.
• glina create <prompt> [--race <race>] [--out <dir>] [--config <path>] — Create.
• glina sculpt <prompt> [--out <dir>] [--filename <file.glb>] [--rounds <n>] [--config <path>] — Sculpt.
• glina verify [<file.glb>] [--config <path>] — Verify.
• glina config check [--config <path>] — Check config.
• glina doctor [--config <path>] — Check the config, the Blender bridge and the browser layer; exit 1 when any check fails.
• glina preview anim [<file.glb>] [--clip <name>] [--frames <n>] [--fps <n>] [--out <file.gif>] [--config <path>] — Preview animation.
• glina preview scene [<file.glb>] [--out <file.png>] [--size <px>] [--config <path>] — Render an asset on neutral ground in Blender.
• glina animate [<file.glb>] --preset <name> [--out <file.glb>] [--config <path>] — Apply a declared motion preset.
• glina showcase <asset> [--out <file.glb>] [--config <path>] — Build a declared animated reference asset.
• glina showcases [list | add <name> <file.json> | remove <name>] — The showcase declarations showcase reads.
• glina presets [list | add <name> <file.json> | remove <name>] — The animation presets animate --preset reads.
• glina setup [--check] [--dry-run] — Setup.
• glina config export --out <path> [--config <path>] — Export config.

MCP protocol method names and MCP tool names are documented separately; they are not human Glina CLI command paths.

Exit codes

An unknown command prints unknown command: <name> followed by usage and exits 2.