{
  "id": "ranger",
  "name": "ranger",
  "homepage": "https://ranger.fm",
  "description": "ranger is a console file manager with VI key bindings.",
  "icon": "https://ranger.fm/ranger_logo.png",
  "executables": [
    "ranger",
    "rifle"
  ],
  "platforms": [
    "macos",
    "linux"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/ranger/"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Browse files with ranger",
    "description": "Open ranger on one or more paths, optionally as a file or directory chooser. Config and cache directory overrides are included; key-listing and copy-config options are not.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "man",
        "kind": "manual",
        "url": "https://manpages.debian.org/unstable/ranger/ranger.1.en.html",
        "revision": "2026-10-27",
        "evidence": "path ...\n-d, --debug\n-c, --clean\n--cachedir=dir\n-r dir, --confdir=dir\n--datadir=dir\n--choosefile=targetfile\n--choosefiles=targetfile\n--choosedir=targetfile\n--selectfile=targetfile\n--show-only-dirs\n"
      }
    ],
    "field": [
      {
        "id": "paths",
        "label": "Paths",
        "description": "Each path opens in a tab. Empty means the current directory.",
        "type": "path",
        "path": {
          "kind": "any",
          "role": "input"
        },
        "position": 0,
        "multiple": true,
        "sources": [
          "man"
        ]
      },
      {
        "id": "clean",
        "label": "Clean mode (no config files read or written)",
        "type": "boolean",
        "option": [
          "--clean",
          "-c"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "debug",
        "label": "Debug mode",
        "type": "boolean",
        "option": [
          "--debug",
          "-d"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "confdir",
        "label": "Config directory",
        "type": "path",
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "option": [
          "--confdir",
          "-r"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "cachedir",
        "label": "Cache directory",
        "type": "path",
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "option": [
          "--cachedir"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "datadir",
        "label": "Data directory",
        "type": "path",
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "option": [
          "--datadir"
        ],
        "sources": [
          "man"
        ]
      },
      {
        "id": "choosefile",
        "label": "Write picked file to",
        "description": "Exit on opening a file and write its absolute path to this file.",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "output"
        },
        "option": [
          "--choosefile"
        ],
        "effect": "overwrite",
        "sources": [
          "man"
        ]
      },
      {
        "id": "choosefiles",
        "label": "Write picked files to",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "output"
        },
        "option": [
          "--choosefiles"
        ],
        "effect": "overwrite",
        "sources": [
          "man"
        ]
      },
      {
        "id": "choosedir",
        "label": "Write last directory to",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "output"
        },
        "option": [
          "--choosedir"
        ],
        "effect": "overwrite",
        "sources": [
          "man"
        ]
      },
      {
        "id": "show_only_dirs",
        "label": "Show only directories",
        "type": "boolean",
        "option": [
          "--show-only-dirs"
        ],
        "sources": [
          "man"
        ]
      }
    ],
    "task": [
      {
        "id": "clean",
        "label": "Start without config",
        "fields": [
          "paths",
          "clean"
        ],
        "required": [],
        "set": {
          "clean": [
            true
          ]
        }
      },
      {
        "id": "choose_dir",
        "label": "Pick a directory",
        "fields": [
          "paths",
          "choosedir",
          "show_only_dirs"
        ],
        "required": [
          "choosedir"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "paths",
          "clean",
          "show_only_dirs",
          "choosedir",
          "choosefile",
          "choosefiles"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "debug",
          "confdir",
          "cachedir",
          "datadir"
        ]
      }
    ]
  }
}