{
  "id": "node-red",
  "name": "Node-RED",
  "homepage": "https://nodered.org/",
  "description": "Low-code programming for event-driven applications",
  "executables": [
    "node-red"
  ],
  "dotfiles": {
    "paths": [
      "~/.node-red/settings.js",
      "~/.node-red/flows*.json"
    ],
    "secret": [
      "~/.node-red/flows*_cred.json"
    ]
  },
  "commands": {
    "format": 1,
    "label": "Start Node-RED",
    "description": "Start the Node-RED runtime. The admin subcommand and telemetry/title options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/node-red/node-red/blob/HEAD/packages/node_modules/node-red/red.js",
        "revision": "red.js usage text 2026-10-27",
        "evidence": "Usage: node-red [-v] [-?] [--settings settings.js] [--userDir DIR]\n                [--port PORT] [--title TITLE] [--safe] [flows.json]\n  -p, --port     PORT  port to listen on\n  -s, --settings FILE  use specified settings file\n  -u, --userDir  DIR   use specified user directory\n  -v, --verbose        enable verbose output\n      --safe           enable safe mode\n"
      }
    ],
    "field": [
      {
        "id": "flows",
        "label": "Flows file",
        "description": "Defaults to flows.json in the user directory.",
        "type": "path",
        "position": 0,
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": false
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "port",
        "label": "Port",
        "type": "integer",
        "option": [
          "--port",
          "-p"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "settings",
        "label": "Settings file",
        "type": "path",
        "option": [
          "--settings",
          "-s"
        ],
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": true
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "user_dir",
        "label": "User directory",
        "type": "path",
        "option": [
          "--userDir",
          "-u"
        ],
        "path": {
          "kind": "directory",
          "role": "input",
          "must_exist": false
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose output",
        "type": "boolean",
        "option": [
          "--verbose",
          "-v"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "safe",
        "label": "Safe mode",
        "description": "Start without running the flows.",
        "type": "boolean",
        "option": [
          "--safe"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "start",
        "label": "Start on a port",
        "fields": [
          "port",
          "user_dir"
        ],
        "required": [
          "port"
        ]
      },
      {
        "id": "safe_start",
        "label": "Start in safe mode",
        "fields": [
          "safe",
          "user_dir"
        ],
        "required": [
          "safe"
        ],
        "set": {
          "safe": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "flows",
          "port",
          "user_dir",
          "safe"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "settings",
          "verbose"
        ]
      }
    ]
  }
}