{
  "id": "nexttrace",
  "name": "NextTrace",
  "homepage": "https://github.com/nxtrace/NTrace-core",
  "description": "An open source visual route tracking CLI tool.",
  "executables": [
    "nexttrace"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/nexttrace/nt_config.yaml"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Trace route",
    "description": "Trace the network path to one host with traditional traceroute or MTR. Web console, speed test, Globalping, file targets and output logging are not in this form.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/nxtrace/NTrace-core",
        "revision": "README 2026-10-27",
        "evidence": "  -4  --ipv4                         Use IPv4 only\n  -6  --ipv6                         Use IPv6 only\n  -T  --tcp                          Use TCP SYN for tracerouting (default\n  -U  --udp                          Use UDP SYN for tracerouting (default\n  -p  --port                         Set the destination port to use. With\n  -q  --queries                      Traceroute: latency samples per hop\n  -m  --max-hops\n  -n  --no-rdns\n  -j  --json\n  -t  --mtr\n  -r  --report\n  -w  --wide\n      --timeout                      Per-probe timeout [ms]. Raise to 2000-3000\n  -C  --no-color\n  -g|--language (en|cn)\n  [-m|--max-hops <integer>] [-n|--no-rdns] [-j|--json] [-t|--mtr] [-r|--report] [-w|--wide] [-C|--no-color] [TARGET \"<value>\"]\nnexttrace --first 5 --max-hops 10 www.decix.net\nnexttrace -t --tcp --max-hops 20 --first 3 --no-rdns 8.8.8.8\n"
      }
    ],
    "field": [
      {
        "id": "target",
        "label": "Target host or IP",
        "type": "string",
        "position": 0,
        "sources": [
          "help"
        ]
      },
      {
        "id": "tcp",
        "label": "Use TCP SYN",
        "type": "boolean",
        "option": [
          "--tcp",
          "-T"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "udp",
        "label": "Use UDP",
        "type": "boolean",
        "option": [
          "--udp",
          "-U"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "ipv4",
        "label": "IPv4 only",
        "type": "boolean",
        "option": [
          "--ipv4",
          "-4"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "ipv6",
        "label": "IPv6 only",
        "type": "boolean",
        "option": [
          "--ipv6",
          "-6"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "port",
        "label": "Destination port",
        "type": "integer",
        "option": [
          "--port",
          "-p"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "queries",
        "label": "Samples per hop",
        "type": "integer",
        "option": [
          "--queries",
          "-q"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "max_hops",
        "label": "Max hops",
        "type": "integer",
        "option": [
          "--max-hops",
          "-m"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "timeout",
        "label": "Per-probe timeout (ms)",
        "type": "integer",
        "option": [
          "--timeout"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_rdns",
        "label": "Skip reverse DNS",
        "type": "boolean",
        "option": [
          "--no-rdns",
          "-n"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "mtr",
        "label": "MTR mode",
        "type": "boolean",
        "option": [
          "--mtr",
          "-t"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "report",
        "label": "MTR report",
        "type": "boolean",
        "option": [
          "--report",
          "-r"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "json",
        "label": "JSON output",
        "type": "boolean",
        "option": [
          "--json",
          "-j"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_color",
        "label": "No color",
        "type": "boolean",
        "option": [
          "--no-color",
          "-C"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "trace",
        "label": "Trace a host",
        "fields": [
          "target",
          "ipv4",
          "ipv6",
          "max_hops",
          "no_rdns"
        ],
        "required": [
          "target"
        ]
      },
      {
        "id": "tcp443",
        "label": "TCP trace to port 443",
        "fields": [
          "target",
          "tcp",
          "port",
          "queries"
        ],
        "required": [
          "target"
        ],
        "set": {
          "tcp": [
            true
          ],
          "port": [
            443
          ]
        }
      },
      {
        "id": "mtr_report",
        "label": "MTR report",
        "fields": [
          "target",
          "mtr",
          "report",
          "queries"
        ],
        "required": [
          "target"
        ],
        "set": {
          "mtr": [
            true
          ],
          "report": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "target",
          "tcp",
          "udp",
          "ipv4",
          "ipv6",
          "port",
          "max_hops",
          "no_rdns"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "queries",
          "timeout",
          "mtr",
          "report",
          "json",
          "no_color"
        ]
      }
    ]
  }
}