Extensions/ComfyUI AF - Find Nodes

ComfyUI Extension

ComfyUI AF - Find Nodes

A ComfyUI extension that allows you to find and locate nodes by their ID, title, pack, or type in complex workflows.

By alFrame·Created about a year ago·Updated 13 days ago· 22

alFrame/ComfyUI-AF-Find-Nodes

Nodes—

On cloudLocal install

Stars22

Updated13 days ago

Readme

ComfyUI AF - Find Nodes

A ComfyUI extension that allows you to find and locate nodes by their ID, title, pack, or type in complex workflows.

ComfyUI reports Node-IDs when it encounters errors, but there's no built-in tool to find those Node-IDs quickly. That's now solved with this custom node/tool.

Ever had this in the console? ComfyUI telling you the Node-ID it got stuck on?

Or this:

On a large workflow that means you will be spending a fair amount of time digging around the workflow canvas...

On top of that, Node-ID's are not visible by default. You have to switch them on in the ComfyUI settings.

Well - Here's the solution!

Simply:

Open AF - Find Nodes (Ctrl+Shift+F)
Type 2170 and press Enter
Instantly locate the problematic node! .. Because the AF - Find Nodes extension will zoom in on the node and highlight it.

Plus it also let's you reverse engineer the Node-ID by activating the "Inspector", which will display the Node-ID.

The AF - FInd Nodes custom node can find nodes by "ID", "Title", and has experimental features that might even help you mitigate redundant node packs installed!

Give it a try - you will not be able to live without it!

BIG FAT WARNING: Currently Subgraph searching is NOT supported.

Features

🔍 Multiple Search Modes

The extension now features a tabbed interface with four search modes:

📍 By ID

Enter any Node-ID to instantly locate and highlight it
Auto-centers the canvas on the found node
Perfect for debugging when error messages reference specific Node-IDs

📛 By Title

Search nodes by their title, color, cnr_id, aux_id, or name
Finds nodes based on your custom naming and organization
Real-time search as you type (searches after 2+ characters)

📦 By Pack (Experimental)

Search for all nodes from a specific pack/extension
Examples: "rgthree", "WAS", "efficiency", "controlnet"
Includes smart alias matching (e.g., "easy" finds "EasyUse")

🔎 By Type (Experimental)

Search by node type/class name
Examples: "KSampler", "CLIPTextEncode", "LoadImage"
Useful for finding all instances of a specific node type

📊 Stats

Workflow overview: total nodes, unique packs, custom packs, and unique node types
Collapsible list of every pack in your workflow, with node count and percentage share
Click any node in a pack's list to select and center it
Export pack lists or node type lists for documentation
Scan is on-demand - click "🔍 Scan Workflow" (or "🔄 Re-scan Workflow") to (re)build the stats after loading or editing a workflow

🔄 Updates

Scan your workflow for nodes with version mismatches
Compare workflow node versions against installed versions
Batch update multiple nodes while preserving connections and values
Smart categorization of update types:
- ✅ Update available (semantic version): Installed version is a newer semver than the workflow's
- ⚠️ Version format changed: Workflow tracked a git hash, installed version is now a semver - review recommended
- ⚠️ Git hash changed: Both versions are git hashes and they differ - review recommended
- ❓ Unable to determine: Can't tell how the versions relate (e.g. missing version info)
Collapsible pack organization for easy navigation
Click any node to select and center it in your workflow
Auto-backup option before applying updates (recommended)
Manual backup button for extra safety
Select individual nodes or entire packs for updating
Core ComfyUI node update warnings
Preserves node connections, widget values, position, size, and styling

How to use the Updates tab:

Switch to the "🔄 Updates" tab
Click "🔍 Scan for Updates" to analyze your workflow
Review the results organized by pack
Enable "Auto-backup before updating" (recommended)
Select nodes to update (individually or by pack)
Click "📥 Update Selected Nodes" to apply updates
Node recreation preserves all connections and values

🎯 Inspector Mode

Available in "By ID" tab only
Click any node to see its ID
Automatically fills the search field with clicked Node-ID
Great for exploring and mapping your workflow

📜 Tab-Specific Search History

Each search mode maintains its own history
Stores up to 10 recent searches per tab
Click any history item to quickly re-search
History persists between sessions

⌨️ Keyboard Shortcuts

Ctrl+Shift+F: Toggle search panel (default - configurable, see below)
Escape: Close search panel
Enter: Execute search

The panel shortcut can be changed (or disabled) in ComfyUI Settings → AF - Nodes → AF - Find Nodes → Shortcuts. Enter any modifier+key combo (e.g. Ctrl+G), or set it to Disabled to turn it off entirely.

🎨 Visual Highlighting

Found nodes are highlighted in orange
Multiple results shown in an interactive list
Click any result to center and highlight that node
Original colors are preserved and restored
Clear highlighting with one click

⚙️ Experimental Features Toggle

Enable/disable experimental search modes (Pack & Type)
Setting persists between sessions
Warning indicators on experimental tabs

Installation

Via ComfyUI Manager (Recommended)

Open ComfyUI Manager
Search for "AF - Find Nodes"
Install

Manual Installation

cd ComfyUI/custom_nodes/
git clone https://github.com/alFrame/ComfyUI-AF-Find-Nodes.git

Usage

Opening the Search Panel

Press Ctrl+Shift+F anywhere in ComfyUI to open the search panel
The panel remembers your last active tab

Finding Nodes by ID

Make sure you're on the "🔍 By ID" tab
Enter a Node-ID in the search field (e.g., 42)
Click "Find" or press Enter
The node will be highlighted and centered on screen

Finding Nodes by Title

Switch to the "📛 By Title" tab
Start typing any part of a node's title, color, or identifier
Results appear automatically as you type
Click any result to jump to that node

Finding Nodes by Pack (Experimental)

Enable experimental features at the bottom of the panel
Switch to the "📦 By Pack" tab
Enter a pack name (e.g., "rgthree", "WAS", "controlnet")
Browse results and click to navigate

Finding Nodes by Type (Experimental)

Enable experimental features at the bottom of the panel
Switch to the "🔎 By Type" tab
Enter a node type (e.g., "KSampler", "CLIP")
View all matching nodes in your workflow

Viewing Workflow Statistics

Switch to the "📊 Stats" tab
Click "🔍 Scan Workflow" - stats are built on-demand, not automatically
View your Workflow Overview:
- Total nodes, unique packs, custom packs, and node types
Browse the Node Packs list:
- Collapsible, scrollable list of every pack in your workflow, sorted by usage (custom packs first, Core last)
- Each pack shows its node count and percentage of the workflow
- Click a pack to expand it and see its individual nodes; click a node to select and center it
Use the Quick Export buttons:
- 📋 Packs: Copy a formatted pack list for README/documentation
- 📝 Types: Copy node types, excluding UUID-named subgraph nodes
- 📝 All: Copy the complete node type list, including UUID-named subgraph nodes
If you've edited the workflow since scanning, click "🔄 Re-scan Workflow" to refresh the stats

General Usage Tips

Using Inspector Mode

Switch to the "🔍 By ID" tab
Click the "Inspector" button to enter inspector mode
Click any node in your workflow to see its ID
The ID will automatically appear in the search field
Click "Exit Inspector" to return to normal mode

Search History

Recent searches appear as clickable buttons below the search field
Each tab maintains its own independent history
Click any history item to quickly search for that node/term again
History is saved and persists between ComfyUI sessions

Perfect For

Debugging workflows when error messages reference Node-IDs
Large workflow navigation - quickly jump to specific nodes
Workflow organization - finding nodes by your custom titles
Pack exploration - locating all nodes from a specific extension
Type analysis - finding all instances of a node type
Workflow documentation - mapping and exploring node relationships

Known Limitations

⚠️ Experimental Features Notice

The "By Pack" and "By Type" search modes are marked as experimental because:

Different node packs use varying conventions for storing metadata
Pack information may not always be consistently available
Some nodes may not be correctly identified by their pack
Results may include false positives or miss some nodes

These features work best with well-structured node packs but may produce unexpected results with others.

Not Compatible with Subgraphs

This extension does not currently support searching within subgraphs or nested workflows.

Compatibility

Works with all ComfyUI workflows
Compatible with custom nodes
No dependencies on other extensions
Pure JavaScript implementation
Actively maintained against current ComfyUI and frontend releases

⚠️ Disclaimer

This ComfyUI custom node is developed through AI-assisted coding. While carefully tested, it is provided "as is" without warranty.

By using this node:

You install and run at your own risk
The creator is not liable for damages or data loss
Compatibility with your setup is not guaranteed
Test in a safe environment before production use

Report issues on GitHub - we appreciate your feedback!

📚 Additional Resources

Changelog - Version history and updates
GitHub Issues - Report bugs & request features
License - GNU GPL v3.0 details

Made with ❤️ by Alex Furer & Qwen3, Claude AI, DeepSeek