{
  "id": "youplot",
  "name": "YouPlot",
  "homepage": "https://github.com/red-data-tools/YouPlot",
  "description": "A command line tool that draws plots on the terminal.",
  "executables": [
    "uplot",
    "youplot"
  ],
  "dotfiles": {
    "paths": [
      "~/.youplotrc",
      "~/.youplot.yml",
      "~/.config/youplot/youplotrc",
      "~/.config/youplot/youplot.yml"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Plot data in the terminal",
    "description": "Draw a bar, histogram, line or scatter plot from files or stdin. Other chart types, colours and progressive mode are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "readme",
        "kind": "help",
        "url": "https://raw.githubusercontent.com/red-data-tools/YouPlot/HEAD/README.md",
        "revision": "2026-10-27",
        "evidence": "`uplot <command> [options] <data.tsv>`\n| barplot   | bar   | draw a horizontal barplot                                |\n| histogram | hist  | draw a horizontal histogram                              |\n| lineplot  | line  | draw a line chart                                        |\n| scatter   | s     | draw a scatter plot                                      |\ncurl -sL https://git.io/ISLANDScsv | sort -nk2 -t, | tail -n15 | uplot bar -d, -t \"Areas of the World's Major Landmasses\"\n| uplot hist --nbins 20\n| uplot line -d, -w 50 -h 15 -t AirPassengers --xlim 1950,1960 --ylim 0,600\n| uplot scatter -H -t IRIS\n`-H` If input data contains a header line, you need to specify the `-H` option.\n`-d` To specify a blank space, you can use `uplot bar -d ' ' data.txt`.\n"
      }
    ],
    "field": [
      {
        "id": "plot",
        "label": "Plot type",
        "type": "enum",
        "position": 0,
        "choices": [
          {
            "value": "bar",
            "label": "Bar"
          },
          {
            "value": "hist",
            "label": "Histogram"
          },
          {
            "value": "line",
            "label": "Line"
          },
          {
            "value": "scatter",
            "label": "Scatter"
          }
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "file",
        "label": "Data file (stdin if empty)",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "position": 1,
        "sources": [
          "readme"
        ]
      },
      {
        "id": "delimiter",
        "label": "Delimiter",
        "type": "string",
        "option": [
          "-d"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "header",
        "label": "Input has a header line",
        "type": "boolean",
        "option": [
          "-H"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "title",
        "label": "Title",
        "type": "string",
        "option": [
          "-t"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "width",
        "label": "Width",
        "type": "integer",
        "option": [
          "-w"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "height",
        "label": "Height",
        "type": "integer",
        "option": [
          "-h"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "nbins",
        "label": "Histogram bins",
        "type": "integer",
        "option": [
          "--nbins"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "xlim",
        "label": "X range (min,max)",
        "type": "string",
        "option": [
          "--xlim"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "ylim",
        "label": "Y range (min,max)",
        "type": "string",
        "option": [
          "--ylim"
        ],
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "plot_file",
        "label": "Plot a file",
        "fields": [
          "plot",
          "file",
          "delimiter",
          "header",
          "title"
        ],
        "required": [
          "plot",
          "file"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "plot",
          "file",
          "delimiter",
          "header",
          "title"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "width",
          "height",
          "nbins",
          "xlim",
          "ylim"
        ]
      }
    ]
  }
}
