{
  "id": "hermit",
  "name": "Hermit",
  "homepage": "https://cashapp.github.io/hermit",
  "description": "Manages isolated, self-bootstrapping sets of tools in software projects.",
  "executables": [
    "hermit"
  ],
  "dotfiles": {
    "paths": [
      "~/.hermit.hcl"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Hermit",
    "description": "Install packages into the active Hermit environment, or install shell hooks. Other commands are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "install"
        ],
        "label": "Install packages",
        "source": [
          {
            "id": "docs",
            "kind": "manual",
            "url": "https://cashapp.github.io/hermit/usage/get-started/",
            "revision": "2026-10-27",
            "evidence": "Once your environment is activated, use hermit search to search for\nproject🐚~/project$ hermit install go-1.16.3"
          }
        ],
        "field": [
          {
            "id": "packages",
            "label": "Packages",
            "description": "For example go-1.16.3.",
            "type": "string",
            "position": 0,
            "multiple": true,
            "sources": [
              "docs"
            ]
          }
        ],
        "task": [
          {
            "id": "install",
            "label": "Install packages",
            "fields": [
              "packages"
            ],
            "required": [
              "packages"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "packages"
            ]
          }
        ]
      },
      {
        "path": [
          "shell-hooks"
        ],
        "label": "Install shell hooks",
        "description": "Writes Hermit hooks into your shell's startup file.",
        "source": [
          {
            "id": "shell",
            "kind": "manual",
            "url": "https://cashapp.github.io/hermit/usage/shell/",
            "revision": "2026-10-27",
            "evidence": "hermit shell-hooks --zsh\nhermit shell-hooks --bash\nhermit shell-hooks --fish"
          }
        ],
        "field": [
          {
            "id": "zsh",
            "label": "zsh",
            "type": "boolean",
            "option": [
              "--zsh"
            ],
            "effect": "overwrite",
            "sources": [
              "shell"
            ]
          },
          {
            "id": "bash",
            "label": "bash",
            "type": "boolean",
            "option": [
              "--bash"
            ],
            "effect": "overwrite",
            "sources": [
              "shell"
            ]
          },
          {
            "id": "fish",
            "label": "fish",
            "type": "boolean",
            "option": [
              "--fish"
            ],
            "effect": "overwrite",
            "sources": [
              "shell"
            ]
          }
        ],
        "task": [
          {
            "id": "zsh",
            "label": "Install for zsh",
            "fields": [
              "zsh"
            ],
            "required": [
              "zsh"
            ],
            "set": {
              "zsh": [
                true
              ]
            }
          },
          {
            "id": "bash",
            "label": "Install for bash",
            "fields": [
              "bash"
            ],
            "required": [
              "bash"
            ],
            "set": {
              "bash": [
                true
              ]
            }
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "zsh",
              "bash",
              "fish"
            ]
          }
        ]
      }
    ]
  }
}