runcomfy-cli

Unified CLI for running hundreds of RunComfy AI models from the command line.

- Supports image generation, video creation, editing, face-swap, lip-sync, upscaling, LoRA training, and more through a single runcomfy run <model_id> command with JSON input

- Handles authentication via interactive login or environment variable, with token stored securely in ~/.config/runcomfy/token.json

- Offers three polling modes: synchronous (submit, poll, download), fire-and-forget with --no-wait, and status checking via runcomfy status <request_id>

- Includes JSON output mode for scripting, batch processing, and piping to other tools; exit codes distinguish retryable errors (75) from fatal ones

- Foundation skill that all other RunComfy intent-routed skills (image-generation, video-generation, face-swap, etc.) dispatch through

RunComfy CLI

One binary, one auth, every RunComfy model. Install once, sign in once, then call any text-to-image, video, edit, lip-sync, face-swap, or LoRA-training endpoint with runcomfy run <model_id> --input '{...}'. This skill is the foundation every other runcomfy-* skill builds on.

runcomfy.com · CLI docs · All models

Install this skill

npx skills add agentspace-so/runcomfy-agent-skills --skill runcomfy-cli -g

Install the CLI

Pick one:

# Global install via npm (recommended for repeat use)
npm i -g @runcomfy/cli