runcomfy-cli

Run RunComfy image, video, and audio models from the command line.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/brillianodhiya/VisionScript --skill runcomfy-cli-brillianodhiya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: runcomfy-cli
Source: https://github.com/brillianodhiya/VisionScript/tree/main/.agents/skills/runcomfy-cli
Command: npx skills add https://github.com/brillianodhiya/VisionScript --skill runcomfy-cli-brillianodhiya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @runcomfy/cli.

What problem does it solve? Calling hosted generative AI models usually requires writing custom API clients, handling authentication, polling job status, and downloading outputs by hand. This Skill teaches the agent to do all of that through the single runcomfy CLI, giving one install and one login for hundreds of image, video, lip-sync, face-swap, and LoRA-training endpoints. ## Core Features & Use Cases - Unified model invocation: Submit any RunComfy model with runcomfy run <vendor>/<model>/<endpoint> --input '{...}', then poll status and download results automatically. - Scriptable automation: Use --output json, --no-wait, and runcomfy status to batch prompts, submit jobs without blocking, and pipe results into jq or shell loops. - Predictable error handling: Documented exit codes (64, 65, 69, 75, 77, 130) distinguish bad input, retryable timeouts/429s, and auth failures so agents can retry or re-authenticate correctly. - Use Case: A user asks to generate 20 product images from a prompts file. The agent loops over the file, calls runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image per prompt, and downloads each result into its own output directory. ## Quick Start Install the CLI with npm, sign in using runcomfy login, then ask the agent to run a RunComfy model such as openai/gpt-image-2/text-to-image with your prompt.

Frequently Asked Questions about runcomfy-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a RunComfy model from the command line?▼

Use runcomfy run with the model id and a JSON input body, for example runcomfy run openai/gpt-image-2/text-to-image --input '{"prompt": "..."}'. The CLI submits the request, polls until completion, and downloads output files to the current directory or --output-dir.

How do I install and authenticate the runcomfy CLI?▼

Install globally with npm i -g @runcomfy/cli or run once with npx -y @runcomfy/cli. Authenticate interactively via runcomfy login using the device-code flow, or set the RUNCOMFY_TOKEN environment variable in CI and containers.

Can I use runcomfy in shell scripts and CI pipelines?▼

Yes. Use --output json for machine-readable output, --no-wait to submit jobs without blocking, and runcomfy status <request_id> to poll later. The RUNCOMFY_TOKEN env var bypasses the local token file for headless environments.

Why does a runcomfy run fail and how do I retry it?▼

The CLI returns exit code 75 for retryable errors like timeouts and 429 rate limits, 69 for upstream 5xx, 65 for bad input JSON, and 77 for auth failures. Wrap retryable codes in a shell loop with exponential backoff; re-authenticate on 77.

How do I find the input schema for a RunComfy model?▼

Every model detail page on runcomfy.com/models has an API tab showing the exact input schema. You can browse the full catalog, curated brand collections like flux-kontext or kling, or capability pages like lip-sync and upscale-video.