{
  "id": "proto",
  "name": "proto",
  "homepage": "https://moonrepo.dev/proto",
  "description": "A pluggable multi-language version manager.",
  "executables": [
    "proto"
  ],
  "dotfiles": {
    "paths": [
      "~/.proto/.prototools",
      "~/.prototools"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "proto",
    "description": "Install one tool with proto install. Other subcommands and post-install hook arguments are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "install"
        ],
        "label": "Install a tool",
        "description": "Install a tool at a version. Without a version it uses the pinned one in .prototools, or latest.",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://moonrepo.dev/docs/proto/commands/install",
            "revision": "2026-10-27",
            "evidence": "$ proto install deno\n$ proto install deno 1.31\n$ proto install deno canary\n$ proto install bun --pin\n[tool]\n - Type of tool.\n[version]\n - Version of tool. Defaults to a pinned version in .prototools or \"latest\".\n--force\n - Force install, even if already installed.\n--build\n - Build from source if available.\n--no-build\n - Download a pre-built if available.\n--pin\n - Pin the resolved version and create a symlink in ~/.proto/bin\n"
          }
        ],
        "field": [
          {
            "id": "tool",
            "label": "Tool",
            "description": "For example deno, bun, node, go.",
            "type": "string",
            "position": 0,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "version",
            "label": "Version",
            "description": "For example 1.31 or canary. Leave empty for the pinned version or latest.",
            "type": "string",
            "position": 1,
            "sources": [
              "docs"
            ]
          },
          {
            "id": "force",
            "label": "Force reinstall",
            "type": "boolean",
            "option": [
              "--force"
            ],
            "effect": "overwrite",
            "sources": [
              "docs"
            ]
          },
          {
            "id": "build",
            "label": "Build from source",
            "type": "boolean",
            "option": [
              "--build"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "no_build",
            "label": "Use a pre-built download",
            "type": "boolean",
            "option": [
              "--no-build"
            ],
            "sources": [
              "docs"
            ]
          },
          {
            "id": "pin",
            "label": "Pin the version",
            "type": "boolean",
            "option": [
              "--pin"
            ],
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "install_pinned",
            "label": "Install and pin",
            "fields": [
              "tool",
              "version",
              "pin"
            ],
            "required": [
              "tool"
            ],
            "set": {
              "pin": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "tool",
              "version",
              "pin"
            ]
          },
          {
            "id": "advanced",
            "label": "Advanced",
            "fields": [
              "force",
              "build",
              "no_build"
            ]
          }
        ]
      }
    ]
  }
}