List Shelf Keys

This is the pack's catalog node. If you've been building shelf keys for a while and can no longer remember whether the character key has twelve fragments or two, List Shelf Keys is the node that tells you - and it can hand those keys to other nodes as data, not just to your eyeballs.

Two inputs, both of them simple. shelf is a dropdown choosing between String Shelf and Resolution Shelf. include_defaults is a boolean that defaults to true; flip it off and you get only the keys you created, which is the fastest way to answer "what did I actually build, versus what shipped with the pack." That's genuinely useful once you've been editing for a while.

Two outputs, and the difference between them matters. keys is a real ComfyUI list output - OUTPUT_IS_LIST in the source - meaning downstream nodes can iterate over all the keys instead of getting one string. keys_csv is the same list joined with commas into a plain string, which is what you want if you're stuffing the key names into a filename, a note node, or some other text sink. The mechanism is straightforward: the node reads the merged shelf data (defaults plus your user overlay), sorts the keys alphabetically, and returns both forms.

There's also a built-in preview that doesn't touch your graph at all. The node body shows an accordion - click a key and it expands: resolution keys show their saved dimensions, string keys show their saved names and text. Because the frontend polls the pack's /prompt-shelf/resolutions and /prompt-shelf/strings API routes with no caching, the preview updates live the moment an editor node saves, updates, or removes an entry. It's a nice touch for a node whose whole job is auditing, and it means you don't need to wire anything to preview - the node is its own inspector.

Install is the single pack install, which is the easy kind. ComfyUI Manager search for comfyui-prompt-shelf, or:

cd ComfyUI/custom_nodes
git clone https://github.com/timonknispel/comfyui-prompt-shelf

Restart ComfyUI, refresh the browser, and everything appears under Prompt Shelf. No requirements.txt, no model downloads, nothing that can fight your other packs.

One practical note on keys_csv: keys are joined with a literal comma, so if you name a key FLUX, video you'll make the CSV output ambiguous. Key names are your own strings and they become CSV entries verbatim - keep commas out of them. And remember the dropdown only has values if the shelf actually has keys: an empty shelf means the node outputs an empty list and an empty string, which is not a bug, just a signal you haven't saved anything yet.