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