{
  "id": "fasd",
  "name": "Fasd",
  "homepage": "https://github.com/clvv/fasd",
  "description": "Fasd offers quick access to files and directories for POSIX shells.",
  "executables": [
    "fasd"
  ],
  "dotfiles": {
    "paths": [
      "~/.fasdrc"
    ],
    "exclude": [
      "~/.fasd"
    ],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Find recent files and directories",
    "description": "Query fasd's frecency database and list or interactively pick matches. Adding/deleting entries (-A, -D), backends and completion are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": true
    },
    "source": [
      {
        "id": "readme",
        "kind": "manual",
        "url": "https://raw.githubusercontent.com/clvv/fasd/HEAD/README.md",
        "revision": "HEAD 2026-10-27",
        "evidence": "    fasd [options] [query ...]\n        -s         list paths with scores\n        -l         list paths without scores\n        -i         interactive mode\n        -e <cmd>   set command to execute on the result file\n        -a         match files and directories\n        -d         match directories only\n        -f         match files only\n        -r         match by rank only\n        -t         match by recent access only\n        -R         reverse listing order\n"
      }
    ],
    "field": [
      {
        "id": "scores",
        "label": "Show scores",
        "type": "boolean",
        "option": [
          "-s"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "list",
        "label": "List without scores",
        "type": "boolean",
        "option": [
          "-l"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "interactive",
        "label": "Interactive",
        "type": "boolean",
        "option": [
          "-i"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "exec",
        "label": "Run command on result",
        "description": "Command executed on the best matching path.",
        "type": "string",
        "option": [
          "-e"
        ],
        "effect": "exec",
        "sources": [
          "readme"
        ]
      },
      {
        "id": "dirs",
        "label": "Directories only",
        "type": "boolean",
        "option": [
          "-d"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "files",
        "label": "Files only",
        "type": "boolean",
        "option": [
          "-f"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "both",
        "label": "Files and directories",
        "type": "boolean",
        "option": [
          "-a"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "rank",
        "label": "By rank only",
        "type": "boolean",
        "option": [
          "-r"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "recent",
        "label": "By recent access only",
        "type": "boolean",
        "option": [
          "-t"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "reverse",
        "label": "Reverse order",
        "type": "boolean",
        "option": [
          "-R"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "query",
        "label": "Query",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "list-dirs",
        "label": "List matching directories with scores",
        "set": {
          "scores": [
            true
          ],
          "dirs": [
            true
          ]
        },
        "fields": [
          "scores",
          "dirs",
          "rank",
          "recent",
          "reverse",
          "query"
        ],
        "required": []
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "query",
          "dirs",
          "files",
          "both",
          "scores",
          "list",
          "interactive"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "exec",
          "rank",
          "recent",
          "reverse"
        ]
      }
    ]
  }
}