comfyui-wildcard-helper

ComfyUI Wildcard Helper

Sidebar browser for the Impact Pack wildcard system in ComfyUI. Created with comfyui-custom-node-template.

Installation

1. Open ComfyUI
2. Go to Manager > Custom Node Manager
3. Search for ComfyUI Wildcard Helper
4. Click Install

<img src="assets/screenshot.png" alt="Screenshot of the ComfyUI Wildcard Helper sidebar">

Features

ComfyUI Wildcard Helper gives you a fast way to:

• browse the full wildcard catalog, including Impact's on-demand mode
• search by token, folder, or path
• inspect a read-only preview for TXT and YAML wildcards
• copy wildcard tokens like __colors/warm__
• stay in sync with Edit > Impact: Refresh Wildcard

Requirements

• ComfyUI-Impact-Pack

The extension degrades cleanly when Impact Pack is missing, but the sidebar is only useful when Impact is installed and loaded.

Development

pnpm install
uv sync --locked --group dev
pnpm dev
pnpm test
pnpm build

Development loop:

• JS or CSS change: browser refresh is enough
• Python bridge change: restart ComfyUI
• Manual QA: open the Wildcards sidebar tab and test against your local Impact wildcard library

Testing

pnpm test runs both layers:

• Vitest for frontend catalog and polling logic
• uv run pytest tests/python -q for backend catalog, entrypoint, and preview behavior

Key checks:

• full catalog appears even when Impact is in on-demand mode
• loaded badges update after Impact refresh
• copy action copies the raw wildcard token
• preview does not mutate Impact's loaded cache and stays bounded for large files
• missing Impact Pack shows an empty state instead of crashing

ComfyUI Validation

After building, verify these in ComfyUI:

1. Open the Wildcards sidebar tab.
2. Confirm the list shows bundled and custom wildcards.
3. Copy a token and paste it into an Impact wildcard field.
4. Modify a wildcard file, run Edit > Impact: Refresh Wildcard, and confirm the sidebar updates while open.
5. Check both TXT and YAML previews.

License

AGPL-3.0-only