{
  "id": "vfox",
  "name": "vfox",
  "homepage": "https://vfox.dev/",
  "description": "A cross-platform SDK version manager",
  "executables": [
    "vfox"
  ],
  "dotfiles": {
    "paths": [
      "~/.vfox/config.yaml",
      "~/.version-fox/config.yaml"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "vfox",
    "description": "Install and switch SDK versions with the vfox version manager.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "install"
        ],
        "label": "Install SDK versions",
        "description": "Install one or more SDKs, e.g. nodejs@20.",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://vfox.dev/usage/core-commands.html",
            "revision": "2026-10-27",
            "evidence": "vfox install nodejs@20 golang ...\n-a, --all: Install all SDK versions recorded in .vfox.toml\n-y, --yes: Quick installation, skip interactive prompts\n--reinstall: Replace an installed version with a fresh copy"
          }
        ],
        "field": [
          {
            "id": "sdks",
            "label": "SDK@version",
            "type": "string",
            "position": 0,
            "multiple": true,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "all",
            "label": "Install all from .vfox.toml",
            "type": "boolean",
            "option": [
              "--all",
              "-a"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "yes",
            "label": "Skip prompts",
            "type": "boolean",
            "option": [
              "--yes",
              "-y"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "reinstall",
            "label": "Reinstall",
            "description": "Replace an installed version with a fresh copy.",
            "type": "boolean",
            "option": [
              "--reinstall"
            ],
            "effect": "overwrite",
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "install",
            "label": "Install SDKs",
            "fields": [
              "sdks",
              "yes"
            ],
            "required": [
              "sdks"
            ]
          },
          {
            "id": "install_all",
            "label": "Install everything in .vfox.toml",
            "fields": [
              "all",
              "yes"
            ],
            "required": [
              "all"
            ],
            "set": {
              "all": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "sdks",
              "all",
              "yes",
              "reinstall"
            ]
          }
        ]
      },
      {
        "path": [
          "use"
        ],
        "label": "Use an SDK version",
        "description": "Set the active version of an SDK in a scope.",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://vfox.dev/usage/core-commands.html",
            "revision": "2026-10-27",
            "evidence": "vfox use [options] <sdk-name>[@<version>]\n-g, --global: Effective globally\n-p, --project: Effective in the current directory($PWD)\n-s, --session: Effective within the current Shell session"
          }
        ],
        "field": [
          {
            "id": "sdk",
            "label": "SDK[@version]",
            "description": "Omit the version to pick from a list.",
            "type": "string",
            "position": 0,
            "min": 1,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "global",
            "label": "Global scope",
            "type": "boolean",
            "option": [
              "--global",
              "-g"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "project",
            "label": "Project scope",
            "description": "Effective in the current directory.",
            "type": "boolean",
            "option": [
              "--project",
              "-p"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "session",
            "label": "Session scope",
            "description": "Effective in the current shell session.",
            "type": "boolean",
            "option": [
              "--session",
              "-s"
            ],
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "use_project",
            "label": "Use for this project",
            "fields": [
              "sdk",
              "project"
            ],
            "required": [
              "sdk",
              "project"
            ],
            "set": {
              "project": [
                true
              ]
            }
          },
          {
            "id": "use_global",
            "label": "Use globally",
            "fields": [
              "sdk",
              "global"
            ],
            "required": [
              "sdk",
              "global"
            ],
            "set": {
              "global": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "sdk",
              "global",
              "project",
              "session"
            ]
          }
        ]
      }
    ]
  }
}