Runcomfy CLI

What it does

When your agent uses it

• Install runcomfy
• Runcomfy whoami
• Any explicit ask to call a RunComfy model from a script

Example prompts

• “runcomfy cli”
• “install runcomfy”
• “runcomfy login”
• “/runcomfy-cli”

Requirements

• Node.js
• A credential in RUNCOMFY_TOKEN
• Pre-approved tools (allowed-tools): Bash(runcomfy *)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1Submit — POSTs the JSON body to model-api.runcomfy.net with your bearer token.
2. 2Poll — GETs the request every ~2s until status is completed, failed, or canceled.
3. 3Download — for each output URL under *.runcomfy.net / *.runcomfy.com, fetch into --output-dir.

What it can do on your machine

Read from SKILL.md and the folder at commit ad8daf7. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(runcomfy *)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • jq
  • npx
  • npm

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • runcomfy.com
  • playgrounds-storage-public.runcomfy.net

  Also links to:

  • skills.sh
  • docs.runcomfy.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • RUNCOMFY_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Runcomfy CLI loads about 3.5k tokens when it runs. Until then it costs about 240 tokens; SKILL.md has 917 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~240

When it runs · the whole SKILL.md, loaded when a task matches

~3.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aiskillstore/marketplace at commit ad8daf7, republished under its MIT licence (© aiskillstore). 917 words, ~3,543 tokens.

name

runcomfy-cli

description

Run any model on RunComfy from the command line. The `runcomfy` CLI is one binary, one auth, hundreds of model endpoints — image generation, image edit, video generation, image-to-video, lip-sync, face swap, video edit, inpainting, outpainting, extend, ControlNet, relight, upscale, LoRA training and more. Submit a request, poll for status, download the output. This skill teaches the agent how to install, authenticate, discover model schemas, invoke models, stream / poll / no-wait, script in JSON output mode, and handle errors. Triggers on "runcomfy cli", "install runcomfy", "runcomfy login", "runcomfy run", "runcomfy whoami", "runcomfy api", or any explicit ask to call a RunComfy model from a script or terminal. Sibling skills (ai-image-generation, ai-video-generation, image-edit, video-edit, face-swap, lipsync, image-to-video, image-inpainting, image-outpainting, video-extend, controlnet-pose, relight) all dispatch through this CLI.

allowed-tools

Bash(runcomfy *)

displayName

RunComfy CLI

homepage

https://www.runcomfy.com

license

MIT

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

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

# Zero-install one-shot (no Node global state)
npx -y @runcomfy/cli --version

runcomfy --version

runcomfy login
# Code shown in terminal — paste into the browser page, click Authorize
# Token saved to ~/.config/runcomfy/token.json with mode 0600

export RUNCOMFY_TOKEN=<token-from-runcomfy.com/profile>

runcomfy whoami
# 📛 you@example.com
#    token type: cli
#    user id: ...

runcomfy run <vendor>/<model>/<endpoint> \
  --input '<JSON body>' \
  --output-dir <path>

runcomfy run openai/gpt-image-2/text-to-image \
  --input '{"prompt": "a small purple cat at sunset, photorealistic"}'

⏳ Submitting request to openai/gpt-image-2/text-to-image
   request_id: 8a3f...
⏳ Polling status (every 2s)...
   in_queue
   in_progress
   completed
✅ completed
{
  "images": [
    "https://playgrounds-storage-public.runcomfy.net/.../result.png"
  ]
}
📥 Downloading 1 file(s) to .
   ./result.png

open https://www.runcomfy.com/models

RID=$(runcomfy --output json run google/nano-banana-2/text-to-image \
  --input '{"prompt": "..."}' --no-wait | jq -r .request_id)

runcomfy status "$RID"

runcomfy --output json run openai/gpt-image-2/text-to-image \
  --input '{"prompt": "X"}' \
  --no-download \
| jq -r '.images[0]'

while IFS= read -r prompt; do
  runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image \
    --input "$(jq -nc --arg p "$prompt" '{prompt:$p, steps:8}')" \
    --output-dir "./out/$(date +%s%N)"
done < prompts.txt

# Submit one or many jobs without blocking
RID=$(runcomfy --output json run bytedance/seedance-v2/pro \
  --input '{"prompt": "..."}' --no-wait | jq -r .request_id)

# Later — possibly from a different shell:
runcomfy status "$RID"

for i in 1 2 3; do
  runcomfy run <model_id> --input '{...}' && break
  rc=$?
  [ $rc -eq 75 ] && sleep $((2**i)) && continue
  exit $rc
done

© aiskillstore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/doany-ai/runcomfy-cli of aiskillstore/marketplace.

• SKILL.md
• skill-report.json

Open the folder on GitHubat commit ad8daf7

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aiskillstore/marketplace, which our catalogue first saw on October 8, 2026.

• majiayu000/claude-skill-registryskills/bash/runcomfy-cliskills/bash/runcomfy-cli-genmedia-labs-skills+1 more