Skip to content

A ComfyUI extension that allows you to find and locate nodes by their ID, title, pack, or type in complex workflows. It also provides a statistics tab, which gives an overview of the custom node packs in use. And now also has a tab to update nodes in workflows to the latest installed version of the node.

License

Notifications You must be signed in to change notification settings

alFrame/ComfyUI-AF-Find-Nodes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

39 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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?

image

Or this:

image

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!

image

Simply:

  1. Open AF - Find Nodes (Ctrl+Shift+F)
  2. Type 2170 and press Enter
  3. 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

image

πŸ“› 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)

image

πŸ“¦ 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")

image

πŸ”Ž By Type (Experimental)

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

image

πŸ“Š 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

image

πŸ”„ 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: Newer version installed
    • ⚠️ Workflow newer: Workflow uses newer version than installed
    • βšͺ Unversioned workflow: Node in workflow has no version info
    • ❌ Unversioned installed: Installed version unknown
  • 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

image

How to use the Updates tab:

  1. Switch to the "πŸ”„ Updates" tab
  2. Click "πŸ” Scan for Updates" to analyze your workflow
  3. Review the results organized by pack
  4. Enable "Auto-backup before updating" (recommended)
  5. Select nodes to update (individually or by pack)
  6. Click "πŸ“₯ Update Selected Nodes" to apply updates
  7. 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
  • 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)

  1. Open ComfyUI Manager
  2. Search for "AF - Pack Prompt Nodes"
  3. 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

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

Finding Nodes by Title

  1. Switch to the "πŸ“› By Title" tab
  2. Start typing any part of a node's title, color, or identifier
  3. Results appear automatically as you type
  4. Click any result to jump to that node

Finding Nodes by Pack (Experimental)

  1. Enable experimental features at the bottom of the panel
  2. Switch to the "πŸ“¦ By Pack" tab
  3. Enter a pack name (e.g., "rgthree", "WAS", "controlnet")
  4. Browse results and click to navigate

Finding Nodes by Type (Experimental)

  1. Enable experimental features at the bottom of the panel
  2. Switch to the "πŸ”Ž By Type" tab
  3. Enter a node type (e.g., "KSampler", "CLIP")
  4. View all matching nodes in your workflow

Viewing Workflow Statistics

  1. Switch to the "πŸ“Š Stats" tab
  2. View your Workflow Overview:
    • Total nodes, unique packs, custom packs, and node types
    • Quick export buttons for documentation
  3. 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
  4. 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
  5. Check the Pack Distribution chart:
    • Visual bar chart showing top 5 packs by usage
    • Quick visual comparison of pack dominance in your workflow
  6. View Node Types Overview:
    • Total unique node types in workflow
    • Count of UUID-based custom nodes/subgraphs
  7. 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
  8. Statistics automatically update when you load or switch workflows

General Usage Tips

Using Inspector Mode

  1. Switch to the "πŸ” By ID" tab
  2. Click the "Inspector" button to enter inspector mode
  3. Click any node in your workflow to see its ID
  4. The ID will automatically appear in the search field
  5. 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


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

About

A ComfyUI extension that allows you to find and locate nodes by their ID, title, pack, or type in complex workflows. It also provides a statistics tab, which gives an overview of the custom node packs in use. And now also has a tab to update nodes in workflows to the latest installed version of the node.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published