Runcomfy CLI

# 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](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [CLI docs](https://docs.runcomfy.com/cli/introduction?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [All models](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli)

## Install this skill

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

## Install the CLI

Pick one:

```bash # 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 ```

A standalone curl-pipe installer also exists for environments without Node — see [docs.runcomfy.com/cli/install](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli). **Inspect any install script before piping it into a shell.** This skill only invokes the CLI via `Bash(runcomfy *)` after you have installed it through one of the verified package managers above.

Confirm:

```bash runcomfy --version ```

Full options on the [Install page](https://docs.runcomfy.com/cli/install?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).

## Sign in

Interactive (opens browser):

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

CI / containers (no browser):

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

Verify:

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

Full flow + token rotation: [Authentication](https://docs.runcomfy.com/cli/auth?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).

## Run a model

The general shape:

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

Example — generate an image with GPT Image 2:

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

You will see:

``` ⏳ 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 ```

By default the result is downloaded to the current directory. Override with `--output-dir ./out`, skip downloading with `--no-download`.

Quickstart: [docs.runcomfy.com/cli/quickstart](https://docs.runcomfy.com/cli/quickstart?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli).

## Discover model schemas

Every model has an `API` tab on its detail page with the exact input schema. Browse the catalog:

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

Or search by collection / capability:

| URL | What | |---|---| | [`/models`](https://www.runcomfy.com/models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) | All featured models | | [`/models/all`](https://www.runcomfy.com/models/all?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) | The full catalog | | [`/models/collections/recently-added`](https://www.runcomfy.com/models/collections/recently-added?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) | Fresh additions | | [`/models/collections/nano-banana`](https://www.runcomfy.com/models/collections/nano-banana?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/seedream`](https://www.runcomfy.com/models/collections/seedream?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/flux-kontext`](https://www.runcomfy.com/models/collections/flux-kontext?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/kling`](https://www.runcomfy.com/models/collections/kling?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/seedance`](https://www.runcomfy.com/models/collections/seedance?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/veo-3`](https://www.runcomfy.com/models/collections/veo-3?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/wan-models`](https://www.runcomfy.com/models/collections/wan-models?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/hailuo`](https://www.runcomfy.com/models/collections/hailuo?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) · [`/qwen-image`](https://www.runcomfy.com/models/collections/qwen-image?utm_source=skills.sh&utm_medium=skill&utm_campaign=runcomfy-cli) | Curated brand collections | | [`/mode