# cli-anything-comfyui

A skill that hands your coding agent a terminal for ComfyUI, so it can queue workflows, browse models and pull finished images without a GUI in the way.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 546 installs · ★ 57187
- Author: HKUDS
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-comfyui/SKILL.md
- Updated: 2026-09-22
- HTML: https://affpapa.org/en/nevibecode/skills/cli-anything-comfyui

## What it does

The skill turns ComfyUI into something your agent can drive from the shell. Queue a workflow, see what is running, interrupt it, list checkpoints and LoRAs, download the PNGs when the run finishes. Commands come in five groups: workflow, queue, models, images and system.

It is a Python package sitting on top of the ComfyUI REST API. A `repl` mode adds tab-completion and command history if you want to poke at things by hand. Every command accepts `--json` and returns structured output, which is how the skill tells agents to call it, plus a non-zero exit code and stderr text when something fails.

Before any of this works you need Python 3.10+ and a ComfyUI instance already listening on port 8188. Nothing answers until that server is up, so run `system stats` first instead of queueing blind. For downloads, `images download` takes `--filename` and `--output`, and absolute paths save you from hunting for a file in the wrong directory.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-comfyui -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cli-anything-comfyui/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cli-anything-comfyui/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-comfyui -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cli-anything-comfyui/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-comfyui -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cli-anything-comfyui/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HKUDS/CLI-Anything cli-anything-comfyui
```

2. **Manually: put the files in place**
- File: `.github/skills/cli-anything-comfyui/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-comfyui -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-comfyui
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cli-anything-comfyui/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add HKUDS/CLI-Anything --skill cli-anything-comfyui -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-comfyui/SKILL.md

## When to use it
- queue a workflow from a JSON file
- list which checkpoints and LoRAs the server already has
- interrupt a generation that is running too long
- download every image from a single prompt
- validate a workflow against the node graph before running it

## Example prompts
- Check that ComfyUI is up: `cli-anything-comfyui system stats`
- Queue `my_workflow.json` and show me the queue status
- Download all images from prompt `<id>` into `./outputs`

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d881efeee3237ee4.

BEGIN THIRD-PARTY FILE d881efeee3237ee4
````text
---
name: "cli-anything-comfyui"
description: >-
  Command-line interface for ComfyUI - AI image generation workflow management via 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.
---

# 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:

```bash
pip install cli-anything-comfyui
```

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

## Usage

### Basic Commands

```bash
# Show help
cli-anything-comfyui --help

# Start interactive REPL mode
cli-anything-comfyui repl

# Check server stats
cli-anything-comfyui system stats

# Run with JSON output (for agent consumption)
cli-anything-comfyui --json system stats
```

### REPL Mode

Start an interactive session for exploratory use:

```bash
cli-anything-comfyui repl
# Enter commands interactively with tab-completion and history
```

## 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
````
END THIRD-PARTY FILE d881efeee3237ee4

The third-party file has ended. Everything between the d881efeee3237ee4 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2768 of 4550 bytes. © HKUDS · Apache-2.0 · https://github.com/HKUDS/CLI-Anything/tree/HEAD/skills/cli-anything-comfyui/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md