Nodes/Shima/Shima Custodian
ComfyUI Node

Shima Custodian

Six buttons that clean up your workflow, your caches, and your sanity

By KDB-USJP·Created 6 months ago·Updated 6 months ago· 2
Shima Custodian

      Some nodes generate images. Some route data. Shima Custodian is the janitor - a panel with six physical-looking buttons that do housekeeping you'd otherwise do by hand or with a terminal: nuke the __pycache__ folders, hide every Dymo label at once, hide every Headline, clear the Use Everywhere group restrictions, open a help menu, or blow away your groups and restrictions entirely. It has no inputs, no outputs, and no data of its own. It's a maintenance console that lives on your canvas.

      How it works

      The backend is essentially an empty shell - execute() returns an empty tuple. Every button action happens in the frontend JavaScript, which is why the node renders as a compact physical chassis with colored buttons instead of a standard node body. The status readout at the bottom ("Deleted 5 caches", "Nuked 3 Groups") is the frontend reporting what it just did. That's the whole mechanism: UI buttons, frontend handlers, immediate feedback.

      The buttons, in order:

      1. ☢️ NUKE PYCACHE (red) - recursively deletes every Python cache folder inside the Shima extension. Handy after updating; stale .pyc files are a classic source of "it works on their machine but not mine" weirdness.
      2. 🏷️ TOGGLE ALL DYMOS (blue) - globally hides or shows every Dymo Label node in the workflow. Dymos are decorative labels; toggling them all is a one-click declutter.
      3. 📰 TOGGLE ALL HEADLINES (blue) - same trick for the Headline text nodes.
      4. 🏝️ CLEAR GROUP-REGS (green) - wipes the Use Everywhere group restrictions (regex) from every node. If a broadcast isn't reaching where it should because of a stale group filter, this is the reset button.
      5. 📂 OPEN EXTRAS (white) - opens a modal with Help, Style Dash, Documentation, and an Excel editor for the style spreadsheets.
      6. 🌋 NUKE GROUPS & REGS (orange) - the deep clean: deletes all groups and all Use Everywhere restrictions. The "I've made a mess, start over" button. Use with care - it's destructive on purpose.

      When you'd use it

      If you're living in big Shima island workflows, the group-reg cleanup buttons are the real draw - Use Everywhere restrictions quietly causing a missing broadcast is a genuinely infuriating failure, and clearing them from one button beats hunting through nodes. The Dymo/Headline toggles matter when you're about to share a workflow and want a clean screenshot. The cache nuke is a "after an update, things are weird" remedy.

      For a small, self-contained graph, honestly, you may never touch it. It's aimed at the power-user end of the pack's audience.

      Installing it

      Part of the Shima pack - ComfyUI Manager → search Shima, or:

      cd ComfyUI/custom_nodes
      git clone https://github.com/KDB-USJP/shima_wf.git Shima
      

      Restart ComfyUI. First launch auto-installs the pack's deps and companion repos (ComfyUI-Impact-Pack, cg-use-everywhere).

      Common issues

      • "The buttons don't do anything." This node is entirely frontend - if the pack's JavaScript isn't loading (a known general hazard with this pack on some setups), the chassis may render but the actions won't fire. Refresh, reinstall, or check the browser console.
      • "It nuked my groups!" Button 6 is destructive by design. The bright orange color is the warning; don't mash it on a workflow you care about without saving first.
      • "Where's the data?" There isn't any. No inputs, no outputs. If you're looking for a processing node, this isn't it - it's a toolbox.

      It's the rare node you'll be glad exists exactly twice a month. When a stale cache or a stubborn group regex is eating your afternoon, six buttons on a chassis beat a terminal session every time.

      CategoryShima/System

      Inputs (0)

      No inputs

      Outputs (0)

      No outputs