ComfyUI-NKD-Radial-Menu

KO | EN

gitlite — search

#shell #graphql #vue #animation #cloud-native #c #api #devops #terminal #awesome-list

ComfyUI-NKD-Radial-Menu

(★ 9)

Radial marking menu for ComfyUI — Alt+Click to open, hold-drag-release to select nodes

File Explorer

ZIP Download

- - publish_action.yml
- - lucide_data.dat
  - nkd_radial.dat
- nkdRadialMenu.js
- mcp_server.mjs
- package.json
.gitignore
__init__.py
pyproject.toml
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A radial marking menu for ComfyUI. Hold Alt+Click on the canvas, drag to a category, drill into it, release on the node you want. It appears where your cursor is and places the node right there.

https://github.com/user-attachments/assets/63f76cfc-a006-4b82-8b49-693a1fe2ef6c

## How it works

**Alt + Click** on empty canvas opens the menu. Hold the mouse button, drag toward a category to expand it, then release on the node to create it. The whole interaction is one gesture.

If you're already dragging an output and press Alt, the menu opens with the link still attached. Pick a node from the menu and it gets created and auto-connected to that output.

It stays out of the way of ComfyUI's own Alt shortcuts. Alt+Click on a node, on a link (to add a reroute) or while dragging a reroute does what it always did; the menu only opens on empty canvas.

If you pick a node that isn't installed (say, from a configuration a friend shared), a toast tells you which node is missing so you can look it up in the Manager.

The wheel can also hold your ComfyUI **Node Templates** (the ones you save with "Save Selected as Template"). Pick one and the whole template, links included, lands where you opened the menu.

## Install

### ComfyUI Manager

Search for **NKD Radial Menu** in the Manager and install.

### Manual

Clone into your `custom_nodes` folder and restart ComfyUI:

```bash
cd ComfyUI/custom_nodes
git clone https://github.com/Nekodificador/NKD-Radial-Menu.git
```

## Configuration

Open **Settings** in ComfyUI. You'll find two entries under NKD Radial Menu:

**Color Palette** chooses the look of the menu. Five built-in palettes: `nkd` (colorful), `ink` (dark monochrome, the default), `paper` (light monochrome), `warm`, and `cool`.

**Configure Radial Menu** opens a modal where you can:

- Add, remove and reorder categories (up to 8)
- Drag categories on the radial preview to rearrange them
- Add nodes to each category by searching their display name (the same names you see in ComfyUI's native search). Your saved Node Templates show up in the same search, marked as templates
- Place each node on any of the 8 wheel slots by clicking the slot you want
- Keep more than 8 nodes per category: the extra ones go to an auxiliary list, and you can swap any of them into the wheel later
- Give a node a short label (up to 5 characters) for the wheel. Without one, the wheel shows the node's display name split over two lines
- Pick icons for categories and individual nodes
- Export and import the full configuration as JSON

Deleting a category or a node asks for confirmation first.

### Adding nodes from the canvas

Right-click any node and choose **Add to Radial Menu**, then the category. Handy when you're already using a node and want it one gesture away next time.

The node's current widget values are saved along with it. Next time you create it from the wheel it comes pre-filled with those values instead of the stock defaults. If the node is already in that category, saving it again just refreshes its values: the wheel entry keeps its icon, slot and label, and nothing gets duplicated. Nodes added from the configuration modal don't carry saved values; the canvas is where you set them.

## Default categories

The menu ships with 8 categories pre-configured:

| Category | Nodes |
|---|---|
| Loaders | Load Checkpoint, Load LoRA, CLIP Loader, VAE Loader, Load Image, Load Video |
| Preview | Preview Image, Save Image, Preview Audio |
| Samplers | KSampler, KSampler Advanced, Sampler Custom, Sampler Custom Advanced |
| Conditioning | CLIP Text Encode, Conditioning Combine, Conditioning Set Area, unCLIP Conditioning |
| Mask | Mask Composite, Invert Mask, Image to Mask, Mask to Image |
| Image | Image Scale, Image Scale By, Image Composite Masked, Image Crop, Image Batch |
| Latent | Empty Latent Image, Latent Upscale, Latent Upscale By, Latent Composite, VAE Decode, VAE Encode |
| Advanced | Reroute, Note, Primitive, Set, Get |

All of them are fully customizable.

## MCP Server (configure with an AI agent)

The extension includes an MCP server that lets any MCP-compatible agent (Claude Code, Claude Desktop, etc.) read and edit your radial menu configuration.

### Setup

```bash
cd ComfyUI/custom_nodes/NKD-Radial-Menu/mcp
npm install
```

Then add the server to your MCP client config:

**Claude Code** (run from your project directory):

```bash
claude mcp add nkd-radial-menu -- node ComfyUI/custom_nodes/NKD-Radial-Menu/mcp/mcp_server.mjs
```

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "nkd-radial-menu": {
      "command": "node",
      "args": ["C:/path/to/ComfyUI/custom_nodes/NKD-Radial-Menu/mcp/mcp_server.mjs"]
    }
  }
}
```

The server reads and writes directly in ComfyUI's settings file (`user/default/comfy.settings.json`). Changes from the MCP and changes from the ComfyUI UI end up in the same place. Reload ComfyUI after editing via the MCP to pick up the new configuration.

If your ComfyUI installation is not at the default relative path, set `NKD_RADIAL_SETTINGS` to the full path of your `comfy.settings.json`.

### Available tools

| Tool | What it does |
|---|---|
| `get_config` | Read the full menu configuration |
| `set_config` | Replace the entire configuration |
| `add_category` | Add a new category (max 8) |
| `update_category` | Update a category by key or index |
| `remove_category` | Remove a category |
| `add_value` | Add a node or Node Template to a category, with optional icon, slot, short label and saved widget values. If it's already there, it's updated in place |
| `remove_value` | Remove a node or Node Template from a category |
| `swap_categories` | Swap two categories by index |

Values are ComfyUI node type IDs (e.g. `KSampler`, `CLIPTextEncode`, `CheckpointLoaderSimple`), either as a plain string or as an object with optional `icon`, `slot` (0 to 7, position on the wheel), `short` (label of up to 5 characters) and `defaults` (widget name to value, applied when the node is created). A Node Template entry uses the template's name as `label` plus `template: true`. Icons are Lucide icon names from [lucide.dev/icons](https://lucide.dev/icons).

## License

MIT

## Credits

- [Lucide](https://lucide.dev/) for the icon set

ComfyUI-NKD-Radial-Menu

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

ComfyUI-NKD-Radial-Menu

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README