Global Commands¶
These commands operate at the workspace level or create new environments. Use
cg <command> -h for the exact parser help in your installed version.
These curated examples target 0.7.0. Brackets denote optional arguments, not
literal shell syntax. Global -e NAME selects an environment before a command.
Workspace Setup¶
cg init [path] [--models-dir PATH] [--yes]
cg list
cg config --show
cg config --uv-cache PATH
cg auth status
cg auth set civitai [--token-stdin]
cg auth set huggingface [--token-stdin]
cg auth set github [--token-stdin]
cg auth login huggingface [--force]
cg auth migrate
cg auth clear PROVIDER
Create, Import, Export, Materialize¶
cg create NAME [--template PATH] [--python VERSION] [--comfyui REF] [--comfyui-repository URL] [--torch-backend BACKEND] [--no-manager] [--use] [--yes]
cg import SOURCE [--name NAME] [--branch REF] [--torch-backend BACKEND] [--models all|required|skip] [--no-manager] [--use] [--yes]
cg export [PATH] [--allow-issues]
cg materialize SOURCE --name NAME [--workspace PATH] [--models-dir PATH] [--branch REF] [--torch-backend BACKEND] [--models all|required|skip] [--with-manager] [--use] [--replace]
Use import for a human authoring environment. Use materialize for
non-interactive runtime or build hydration.
Analyze¶
Analyze a workflow file without selecting an environment:
cg analyze workflow.json
cg analyze workflow.json --json
cg analyze workflow.json --draft-spec
cg analyze workflow.json --online
cg analyze workflow.json --verbose
cg analyze workflow.json --quiet
Models¶
cg model index status
cg model index dir PATH
cg model index sync
cg model index list [--duplicates] [--json]
cg model index find QUERY
cg model index show IDENTIFIER
cg model download URL [--path RELATIVE_PATH] [--category CATEGORY] [--yes]
cg model add-source [MODEL] [URL]
cg model delete IDENTIFIER [--yes]
Registry, Updates, Debugging¶
cg registry status
cg registry update
cg update [--check]
cg debug [-n LINES] [--level DEBUG|INFO|WARNING|ERROR] [--full] [--workspace]
Orchestrator And Workspace Maintenance¶
cg orch status [--json]
cg orch restart [--wait] [--timeout SECONDS] [--json]
cg orch kill [--force]
cg orch clean [--dry-run] [--force] [--kill]
cg orch logs [--follow] [-n LINES]
cg workspace cleanup [--force]
cg orchestrator is an alias for cg orch.
For a named runtime launched by current cg run, use cg -e NAME orch status
--json and cg -e NAME orch restart --wait --json. Restart verifies identity
and an idle queue; read the runtime guide
for prerequisites and limitations.
Storage Inventory¶
Inventory reports shared models, environments, and optionally measured storage. It does not automatically delete duplicate files or developer-owned checkouts.