ComfyUI Extension: ComfyUI AF - Find Nodes

Authored by alFrame

Created 4 months ago

Updated 17 days ago

3 stars

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

Custom Nodes (0)

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

View comprehensive workflow statistics and analytics
See top custom packs ranked with medals (🥇🥈🥉)
Identify cleanup opportunities (packs with only 1-2 nodes)
Visual pack distribution charts
Export pack lists and node types for documentation
Automatic workflow scanning and indexing

🎯 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
Escape: Close search panel
Enter: Execute search (in ID mode)

🎨 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 - Pack Prompt Nodes"
Install

Manual Installation

cd ComfyUI/custom_nodes/
git clone ttps://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
View your Workflow Overview:
- Total nodes, unique packs, custom packs, and node types
- Quick export buttons for documentation
Browse the All Node Packs list:
- Complete scrollable list of all packs in your workflow
- Packs ranked by usage with visual indicators
- Color-coded: Core ComfyUI nodes (blue), Low-usage packs (green)
- Each pack shows node count and percentage distribution
Review Cleanup Opportunities (if applicable):
- Automatically identifies packs with only 1-2 nodes
- Helps you spot redundant or rarely-used custom nodes
- Consider consolidating or removing these for a cleaner workflow
Check the Pack Distribution chart:
- Visual bar chart showing top 5 packs by usage
- Quick visual comparison of pack dominance in your workflow
View Node Types Overview:
- Total unique node types in workflow
- Count of UUID-based custom nodes/subgraphs
Use Quick Export buttons (at top of Stats tab):
- 📋 Packs: Copy formatted pack list for README/documentation
- 📝 Filtered Types: Export node types excluding UUIDs
- 📄 All Types: Export complete node type list including UUIDs
Statistics automatically update when you load or switch workflows

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
Tested with ComfyUI v0.0.04+

⚠️ 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 - MIT License details

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