cli-anything-comfyui skill by hkuds

cli-anything-comfyui

AI image generation workflow management via the ComfyUI REST API. Designed for AI agents and power users who need to queue workflows, manage models, download generated images, and monitor the generation queue without a GUI.

Installation

This CLI is installed as part of the cli-anything-comfyui package:

pip install cli-anything-comfyui

Prerequisites:

Python 3.10+
ComfyUI must be installed and running at http://localhost:8188

Usage

Basic Commands

# Show help
cli-anything-comfyui --help
 
# Start interactive REPL mode
cli-anything-comfyui repl
 
# Check server stats

REPL Mode

Start an interactive session for exploratory use:

Command Groups

Workflow

Workflow management commands.

Command	Description
`list`	List saved workflows
`load`	Load a workflow from a JSON file
`validate`	Validate a workflow JSON against the ComfyUI node graph

Queue

Generation queue management.

Command	Description
`prompt`	Queue a workflow for execution
`status`	Show current queue status (running and pending)
`clear`	Clear the generation queue
`history`	Show prompt execution history
`interrupt`	Interrupt the currently running generation

Models

Model discovery commands.

Command	Description
`checkpoints`	List available checkpoint models
`loras`	List available LoRA models
`vaes`	List available VAE models
`controlnets`	List available ControlNet models
`node-info`	Show detailed info for a specific node type
`list-nodes`	List all available node types

Images

Generated image management.

Command	Description
`list`	List generated images on the server
`download`	Download a specific generated image
`download-all`	Download all images from a prompt execution

System

Server status and information.

Command	Description
`stats`	Show ComfyUI system statistics (GPU, CPU, memory)
`info`	Show ComfyUI server info and extensions

Examples

Check System Status

Discover Available Models

Queue and Monitor Generation

Download Generated Images

Output Formats

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (--json flag): Structured JSON for agent consumption

For AI Agents

When using this CLI programmatically:

Always use --json flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure
Use absolute paths for all file operations
Verify ComfyUI is running with system stats before other commands

More Information

Full documentation: See README.md in the package
Test coverage: See TEST.md in the package
Methodology: See HARNESS.md in the cli-anything-plugin

Version

1.0.0