Nodes/BrainDead Nodes/BD Workflow Version List
ComfyUI Node

BD Workflow Version List

Read your workflow's version history before you panic-restore

By BizaNator·Created 8 months ago·Updated 3 days ago· 15
BD Workflow Version List
    • version_list
    • diff_result
    • total_versions
    workflow_id
    show_hashestrue
    max_display20
    compare_version_a0
    compare_version_b0

    Once you've got BD Workflow Version Cache quietly snapshotting your workflow every time it changes, you need a way to actually see what you've saved - which version is which, when it happened, and what changed between two of them. That's this node. BD Workflow Version List reads the saved history for a workflow and hands it to you as text you can read in the node's output, plus a bonus diff between any two versions.

    It's the "look before you leap" companion to BD Workflow Version Restore. You don't restore blind; you list, pick the version number that looks right, then restore that one.

    The inputs

    • workflow_id - the one to look up. Wire it from the workflow_id output of BD Workflow Version Cache so you never have to type a hash. (The List node is picky: an empty ID just returns an error.)
    • show_hashes (default true) - include the workflow hash in the listing. Useful for spotting "same state saved twice"; turn off if the columns get too wide.
    • max_display (default 20) - how many versions to show before the "... and N more" truncation. Your history can run to dozens; you usually only need the recent ones.
    • compare_version_a / compare_version_b - set both (non-zero) and the node runs a comparison, returning a summary of what changed between those two versions in diff_result. This is the killer feature when you've broken something: diff the working version against the broken one and see exactly which nodes moved.

    Outputs: version_list (the formatted table - version number, timestamp, node count, hash, description), diff_result (the comparison summary if you set both compare inputs), and total_versions.

    Installation

    Standard BrainDead pack install:

    cd ComfyUI/custom_nodes
    git clone https://github.com/BizaNator/ComfyUI-BrainDead
    cd ComfyUI-BrainDead
    pip install -r requirements.txt
    

    Or ComfyUI Manager → search "BrainDead". No models, no dependencies beyond the pack itself; it reads the version metadata the Cache node wrote under output/BrainDead_Cache/workflow_versions/.

    Common issues

    • "workflow_id is required" - you left it empty. Unlike the Cache node, List doesn't auto-detect; it needs the ID. Wire it from Cache's workflow_id output and this stops being a problem.
    • "No versions found" - either you've never run the Cache node for that ID, or you typed a different ID than the one that's saving. The auto-generated IDs change when the workflow structure changes, so if you restructured the graph, the old history lives under a different ID.
    • diff_result is empty - you set only one of the compare inputs, or one of them is 0. Both must be set to non-zero to trigger a comparison.
    Category🧠BrainDead/Cache

    Inputs (5)

    NameTypeDefaultDescription
    workflow_idSTRING
    show_hashesBOOLEANtrue
    max_displayINT201–100
    compare_version_aoptINT00–9999
    compare_version_boptINT00–9999

    Outputs (3)

    NameTypeDescription
    version_listSTRING
    diff_resultSTRING
    total_versionsINT