{
  "id": "superfile",
  "name": "superfile",
  "homepage": "https://superfile.dev",
  "description": "A modern terminal file manager.",
  "executables": [
    "spf"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/superfile/config.toml",
      "~/.config/superfile/hotkeys.toml",
      "~/Library/Application Support/superfile/config.toml",
      "~/Library/Application Support/superfile/hotkeys.toml",
      "%LOCALAPPDATA%/superfile/config.toml",
      "%LOCALAPPDATA%/superfile/hotkeys.toml"
    ],
    "exclude": [
      "~/.local/state/superfile/",
      "~/Library/Application Support/superfile/*.log",
      "%LOCALAPPDATA%/superfile/*.log"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "superfile",
    "description": "Start superfile in one or more directories, optionally with custom config or hotkey files. Maintenance subcommands are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "docs",
        "kind": "manual",
        "url": "https://raw.githubusercontent.com/yorukot/superfile/HEAD/website/src/content/docs/configure/config-file-path.mdx",
        "revision": "2026-10-27",
        "evidence": "You can use the `-c` or `--config-file` flag to specify a different path for the `config.toml` file:\nspf -c /path/to/your/config.toml\nYou can use the `--hotkey-file` flag to specify a different path for the `hotkey.toml` file:\nspf --hotkey-file /path/to/your/hotkey.toml\nArgsUsage:   \"[PATH]...\"\n"
      }
    ],
    "field": [
      {
        "id": "paths",
        "label": "Start directories",
        "description": "One or more directories to open as panels.",
        "type": "path",
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "position": 0,
        "multiple": true,
        "sources": [
          "docs"
        ]
      },
      {
        "id": "config_file",
        "label": "Config file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "option": [
          "--config-file",
          "-c"
        ],
        "sources": [
          "docs"
        ]
      },
      {
        "id": "hotkey_file",
        "label": "Hotkey file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "option": [
          "--hotkey-file"
        ],
        "sources": [
          "docs"
        ]
      }
    ],
    "task": [
      {
        "id": "open",
        "label": "Open directories",
        "fields": [
          "paths"
        ]
      },
      {
        "id": "custom_config",
        "label": "Open with custom config",
        "fields": [
          "paths",
          "config_file",
          "hotkey_file"
        ],
        "required": [
          "config_file"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "paths",
          "config_file",
          "hotkey_file"
        ]
      }
    ]
  }
}