Save Images (ShellAgent Plugin)

Save Images (ShellAgent Plugin) is the plural version of the pack's Save Image - and that plural is the entire point. Both subclass ComfyUI's stock Save Image and behave identically on the disk side: same PNG output, same filename_prefix with %date% and %node.field% tokens, same workflow-embedded-in-metadata behavior. The difference is what they tell the parent app: the singular node advertises one image, this one advertises an array of images.

If your workflow legitimately produces several images (a batch of variations, a grid of frames, multiple faces) and you want ShellAgent to hand all of them to the user, this is the node to terminate the branch with.

How it works

Mechanically it's the same save_images call as the stock node - write files, embed metadata - plus a validate() method that returns a schema of type: array with items: {type: string, url_type: image}. The app sees "this workflow outputs N image URLs" and renders them as a gallery instead of a single picture. The images output is a pass-through of the batch, so you can keep wiring downstream even though it's flagged as an output node.

Like its singular sibling it also has the encrypt toggle, which XOR-scrambles every saved file with the pack's hardcoded key (ShellAgentSecretKey2024!). On by default for nothing - you opt in. If you accidentally leave it on, you'll get a folder of unopenable PNGs, which is confusing exactly once.

Inputs

• images - the batch to save. Feed it the whole IMAGE batch, not a single frame.
• output_name - the array's name in the app's result. Default output_image; rename it so the app's schema doesn't clash with a singular save elsewhere.
• filename_prefix - same as stock, defaults to ComfyUI.
• encrypt - off unless you're protecting the files.

Installing it

One install, same as every node in this pack:

cd ComfyUI/custom_nodes
git clone https://github.com/myshell-ai/ComfyUI-ShellAgent-Plugin

restart, or search ComfyUI-ShellAgent-Plugin in ComfyUI Manager. No models to fetch; the pack's requirements (opencv-python, pillow_heif, imageio-ffmpeg, pydantic, …) install with it.

Common issues

• The app only shows my last image. You probably used the singular Save Image node instead of this one - or fed it a single-image batch. This node is the array variant.
• Files saved but unopenable. encrypt is on. Decrypt via the pack's Input Image node (encrypt toggle on) or re-run with it off.
• Same output_name on two save nodes. The app schema gets confused about which is which; give each a distinct name.

It's a one-trick node, but the trick matters if you're shipping batches. When in doubt between the two: one image → Save Image, several → Save Images.