---

Workflow Snapshot Manager automatically captures your ComfyUI workflow as you edit. Browse, name, search, and restore any previous version from a sidebar panel — all stored locally in your browser's IndexedDB.

Features

• Auto-capture — Snapshots are saved automatically as you edit, with configurable debounce
• Custom naming — Name your snapshots when taking them manually ("Before merge", "Working v2", etc.)
• Search & filter — Quickly find snapshots by name with the filter bar
• Restore or Swap — Open a snapshot as a new workflow, or replace the current one in-place
• Per-workflow storage — Each workflow has its own independent snapshot history
• Theme-aware UI — Adapts to light and dark ComfyUI themes
• Toast notifications — Visual feedback for save, restore, and error operations
• Concurrency-safe — Lock guard prevents double-click issues during restore
• Zero backend — Pure frontend extension, no server dependencies

Installation

ComfyUI Manager (Recommended)

Search for Workflow Snapshot Manager in ComfyUI Manager and click Install.

Git Clone

cd ComfyUI/custom_nodes
git clone https://github.com/ethanfel/Comfyui-Workflow-Snapshot-Manager.git

Restart ComfyUI after installing.

Usage

1. Open the Sidebar

Click the clock icon () in the ComfyUI sidebar to open the Snapshots panel.

2. Snapshots are Captured Automatically

As you edit your workflow, snapshots are saved automatically after a configurable delay (default: 3 seconds). An initial snapshot is also captured when the workflow loads.

3. Take a Named Snapshot

Click Take Snapshot to manually save the current state. A prompt lets you enter a custom name — great for checkpoints like "Before refactor" or "Working config".

4. Search & Filter

Use the filter bar at the top of the panel to search snapshots by name. The clear button (×) resets the filter.

5. Restore or Swap

Each snapshot has two action buttons:

Button	Action
Swap	Replaces the current workflow in-place (same tab)
Restore	Opens the snapshot as a new workflow

6. Delete & Clear

• Click × on any snapshot to delete it individually
• Click Clear All Snapshots in the footer to remove all snapshots for the current workflow (with confirmation dialog)

Settings

All settings are available in ComfyUI Settings > Snapshot Manager > Capture Settings:

Setting	Type	Default	Description
Auto-capture on edit	Toggle	On	Automatically save snapshots when the workflow changes
Capture delay	Slider	3s	Seconds to wait after the last edit before auto-capturing (1–30s)
Max snapshots per workflow	Slider	50	Maximum number of snapshots kept per workflow (5–200). Oldest are pruned automatically
Capture on workflow load	Toggle	On	Save an "Initial" snapshot when a workflow is first loaded

Architecture

Data flow:

1. Graph edits trigger a graphChanged event
2. A debounce timer prevents excessive writes
3. The workflow is serialized and hash-checked against the last capture (per-workflow) to avoid duplicates
4. New snapshots are written to IndexedDB (browser-local, persistent)
5. The sidebar panel reads from IndexedDB and renders the snapshot list
6. Restore/Swap loads graph data back into ComfyUI with a lock guard to prevent concurrent operations

Storage: All data stays in your browser's IndexedDB — nothing is sent to any server. Snapshots persist across browser sessions and ComfyUI restarts.

FAQ

Where are snapshots stored? In your browser's IndexedDB under the database ComfySnapshotManager. They persist across sessions but are browser-local (not synced between devices).

Will this slow down ComfyUI? No. Snapshots are captured asynchronously after a debounce delay. The hash check prevents redundant writes.

What happens if I switch workflows? Each workflow has its own snapshot history. Switching workflows cancels any pending captures and shows the correct snapshot list.

Can I use this with ComfyUI Manager? Yes — install via ComfyUI Manager or clone the repo into custom_nodes/.

License

MIT