ComfyUI Prompt Saver

A ComfyUI custom node that saves images alongside formatted prompt reference cards for easy browsing and organization.

Features

• Reference Cards: Creates side-by-side images with thumbnail + formatted prompt text
• JSON Syntax Highlighting: Automatically highlights JSON prompts with color-coded keys, values, and braces
• Multiple Output Formats: Save full image, reference card, and/or JSON metadata
• Auto Text Sizing: Dynamically adjusts font size to fit prompts in available space
• Prompt Cleaning: Handles escaped characters and JSON parsing automatically

Example Output

The reference card displays your generated image as a thumbnail alongside the formatted prompt:

┌─────────────────────────────────────────────────┐
│  ┌──────────┐  {                                │
│  │          │    "scene": "mountain landscape", │
│  │  Image   │    "style": "oil painting",       │
│  │ Thumbnail│    "lighting": "golden hour"      │
│  │          │  }                                │
│  └──────────┘                                   │
└─────────────────────────────────────────────────┘

Installation

Via ComfyUI Manager (Recommended)

1. Open ComfyUI Manager
2. Search for "Prompt Saver"
3. Click Install

Manual Installation

cd ComfyUI/custom_nodes
git clone https://github.com/robomello/comfyui-prompt-saver

Restart ComfyUI after installation.

Usage

1. Find the node under image/save category as "Save Image + Prompt Reference"
2. Connect your image output and prompt string
3. Configure options as needed

Inputs

| Input | Type | Description | |-------|------|-------------| | images | IMAGE | Required. The generated image(s) to save | | prompt | STRING | Required. The prompt text (supports plain text or JSON) | | filename_prefix | STRING | Prefix for saved files (default: "prompt_ref") | | thumbnail_size | INT | Size of thumbnail in reference card (128-1024, default: 512) | | save_full_image | BOOLEAN | Save the full-resolution image (default: True) | | save_reference_card | BOOLEAN | Save the reference card with thumbnail + prompt (default: True) | | save_json | BOOLEAN | Save prompt metadata as JSON file (default: True) | | negative_prompt | STRING | Optional. Negative prompt to include in metadata | | extra_metadata | STRING | Optional. Additional metadata to include |

Outputs

| Output | Type | Description | |--------|------|-------------| | images | IMAGE | Passthrough of input images | | saved_path | STRING | Comma-separated list of saved file paths |

Output Files

Files are saved to ComfyUI/output/prompt_references/ with the following naming:

• {prefix}_{timestamp}_{index}_full.png - Full resolution image
• {prefix}_{timestamp}_{index}_ref.png - Reference card
• {prefix}_{timestamp}_{index}.json - Prompt metadata

Requirements

• ComfyUI
• Pillow
• numpy

License

MIT License - see LICENSE

Author

Roberto de Mello (@robomello)