HouseKeeper - ComfyUI Node Alignment Tool

A simple ComfyUI custom node that provides node alignment tools and an interactive drawing canvas.

Features

• Smart node alignment for multiple selected nodes
• 6 alignment options: Left, Right, Top, Bottom, H-flow, V-flow
• Keyboard shortcuts for quick alignment
• Auto-appearing alignment panel

Installation

Navigate to your ComfyUI custom nodes directory and clone:

cd ComfyUI/custom_nodes/
git clone https://github.com/joanna910225/comfyui-housekeeper.git
cd comfyui-housekeeper
npm install
npm run build

Restart ComfyUI to load the new nodes.

Usage

Node Alignment

1. Select multiple nodes (2 or more) in ComfyUI
2. Alignment panel appears automatically in top-right corner
3. Click alignment buttons or use keyboard shortcuts:

Basic Alignment:

• Ctrl+Shift+← - Align Left (align to leftmost node)
• Ctrl+Shift+→ - Align Right (align to rightmost node)
• Ctrl+Shift+↑ - Align Top (align to topmost node)
• Ctrl+Shift+↓ - Align Bottom (align to bottommost node)

Flow Alignment:

• Alt+→ - H-Flow (arrange nodes horizontally by workflow connections)
• Alt+↓ - V-Flow (arrange nodes vertically by workflow connections)

How Flow Alignment Works:

• H-Flow: Analyzes node connections and arranges them left-to-right in columns based on their workflow dependencies
• V-Flow: Analyzes node connections and arranges them top-to-bottom in rows based on their workflow dependencies
• Flow alignment respects the selected nodes' bounding box and positions relative to existing connections