{
  "id": "glances",
  "name": "Glances",
  "homepage": "https://github.com/nicolargo/glances",
  "description": "A cross-platform curses-based monitoring tool.",
  "executables": [
    "glances"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/glances/glances.conf",
      "[appData]/glances/glances.conf"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false,
    "secret_paths": [
      {
        "file": [
          "[configHome]/glances/glances.conf",
          "[appData]/glances/glances.conf"
        ],
        "match": {
          "prefix": [
            "password",
            "ssl_keyfile_password"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Run Glances",
    "description": "Start the Glances monitor in the terminal, as a web/API server, or connected to a remote Glances server. Exporters other than CSV and JSON, authentication and MCP options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": true
    },
    "source": [
      {
        "id": "man",
        "kind": "manual",
        "url": "https://github.com/nicolargo/glances/blob/develop/docs/man/glances.1",
        "revision": "develop 2026-10-27",
        "evidence": "-t <sec>, --time <sec>: refresh rate in seconds (overrides [global] refresh) [default: 2 sec]\n-C <path>, --config <path>: path to the glances.conf file to use\n--disable-plugin <a,b>, --disable-plugins <a,b>, --disable <a,b>: disable plugins (comma-separated list or all)\n--enable-plugin <a,b>, --enable-plugins <a,b>, --enable <a,b>: enable plugins (comma-separated list)\n--stop-after <n>: stop after n refreshes\n-s, --server, -w, --webserver: run as a REST API server (FastAPI, /api/5) and serve the Web UI\n-B <addr>, --bind <addr>: bind address [default: 127.0.0.1]\n-p <n>, --port <n>: listening port [default: 61208]\n--disable-webui: serve the REST API without the Web UI (requires --server)\n--open-web-browser: open the Web UI in the default Web browser at startup\n-c <server>, --client <server>: show a remote Glances v5 server in the TUI: host, host:port\n-q, --quiet, --no-tui: disable the curses TUI (for example to only run the exports)\n--export <a,b>: enable export modules (comma-separated list, e.g. csv,influxdb2)\n--export-csv-file <path>: file path for the CSV exporter [default: ./glances.csv]\n--stdout <plugin[.key].attr,...>: print stats to stdout, one line per stat and refresh\n--stdout-json <plugin,...>: print the selected plugins' stats to stdout as one JSON object\n"
      }
    ],
    "field": [
      {
        "id": "time",
        "label": "Refresh interval (seconds)",
        "type": "number",
        "option": [
          "--time",
          "-t"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "config",
        "label": "Config file",
        "type": "path",
        "option": [
          "--config",
          "-C"
        ],
        "path": {
          "kind": "file",
          "role": "input",
          "must_exist": true
        },
        "sources": [
          "man"
        ]
      },
      {
        "id": "disable_plugin",
        "label": "Disable plugins",
        "description": "Comma-separated plugin names, or all.",
        "type": "string",
        "option": [
          "--disable-plugin"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "enable_plugin",
        "label": "Enable plugins",
        "description": "Comma-separated plugin names.",
        "type": "string",
        "option": [
          "--enable-plugin"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "stop_after",
        "label": "Stop after N refreshes",
        "type": "integer",
        "option": [
          "--stop-after"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "webserver",
        "label": "Run as web / API server",
        "type": "boolean",
        "option": [
          "--webserver",
          "-w"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "bind",
        "label": "Bind address",
        "type": "string",
        "option": [
          "--bind",
          "-B"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "port",
        "label": "Port",
        "type": "integer",
        "option": [
          "--port",
          "-p"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "disable_webui",
        "label": "API only (no web UI)",
        "type": "boolean",
        "option": [
          "--disable-webui"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "open_web_browser",
        "label": "Open web UI in browser",
        "type": "boolean",
        "option": [
          "--open-web-browser"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "client",
        "label": "Remote server to view",
        "description": "host or host:port of a Glances server.",
        "type": "string",
        "option": [
          "--client",
          "-c"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "quiet",
        "label": "No TUI",
        "type": "boolean",
        "option": [
          "--quiet",
          "-q"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "export",
        "label": "Export modules",
        "type": "string",
        "option": [
          "--export"
        ],
        "suggestions": [
          {
            "value": "csv",
            "label": "CSV"
          },
          {
            "value": "json",
            "label": "JSON"
          }
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "export_csv_file",
        "label": "CSV export file",
        "type": "path",
        "option": [
          "--export-csv-file"
        ],
        "path": {
          "kind": "file",
          "role": "output",
          "must_exist": false
        },
        "effect": "overwrite",
        "sources": [
          "man"
        ]
      },
      {
        "id": "stdout",
        "label": "Print stats to stdout",
        "description": "Comma-separated plugin[.key].attr list.",
        "type": "string",
        "option": [
          "--stdout"
        ],
        "sources": [
          "man"
        ]
      }
    ],
    "task": [
      {
        "id": "web",
        "label": "Web server",
        "fields": [
          "webserver",
          "bind",
          "port",
          "disable_webui",
          "open_web_browser"
        ],
        "required": [
          "webserver"
        ],
        "set": {
          "webserver": [
            true
          ]
        },
        "lock": [
          "webserver"
        ]
      },
      {
        "id": "remote",
        "label": "View a remote server",
        "fields": [
          "client",
          "time"
        ],
        "required": [
          "client"
        ]
      },
      {
        "id": "stdout",
        "label": "Print stats",
        "fields": [
          "stdout",
          "time",
          "stop_after"
        ],
        "required": [
          "stdout"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "time",
          "config",
          "webserver",
          "bind",
          "port",
          "client",
          "stdout"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "disable_plugin",
          "enable_plugin",
          "stop_after",
          "disable_webui",
          "open_web_browser",
          "quiet",
          "export",
          "export_csv_file"
        ]
      }
    ]
  }
}
