{
  "id": "gollama",
  "name": "Gollama",
  "homepage": "https://github.com/sammcj/gollama",
  "description": "A terminal UI for managing Ollama models.",
  "executables": [
    "gollama"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/gollama/config.json",
      "~/.config/gollama/themes/"
    ],
    "exclude": [
      "~/.config/gollama/gollama.log"
    ],
    "secret": [],
    "secret_paths": [
      {
        "file": "~/.config/gollama/config.json",
        "format": "json",
        "match": {
          "key_path": [
            "ollama_api_key"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "List, search or estimate models",
    "description": "Non-interactive Gollama jobs: list or search Ollama models, edit a Modelfile, or estimate vRAM. The interactive TUI (no flags) and model-linking options are not covered.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "readme",
        "kind": "help",
        "url": "https://raw.githubusercontent.com/sammcj/gollama/HEAD/README.md",
        "revision": "2026-10-27",
        "evidence": "gollama -l\ngollama -e my-model\ngollama -s my-model # returns models that contain 'my-model'\ngollama -s 'my-model|my-other-model' # returns models that contain either 'my-model' or 'my-other-model'\ngollama --vram llama3.1:8b-instruct-q6_K\ngollama --vram NousResearch/Hermes-2-Theta-Llama-3-8B --fits 6\n  - `--fits`: Available memory in GB for context calculation (e.g. `6` for 6GB)\n  - `--vram-to-nth` or `--context`: Maximum context length to analyze (e.g. `32k` or `128k`)\n  - `--quant`: Override quantisation level (e.g. `Q4_0`, `Q5_K_M`)\ngollama --create-from-lmstudio --log-level debug\nAvailable log levels: `debug`, `info`, `warn`, `error`\n"
      }
    ],
    "field": [
      {
        "id": "list",
        "label": "List models",
        "description": "Print the model list without starting the TUI.",
        "type": "boolean",
        "option": [
          "-l"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "search",
        "label": "Search models",
        "description": "Substring; use | for either term and & for both.",
        "type": "string",
        "option": [
          "-s"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "edit",
        "label": "Edit Modelfile of",
        "type": "string",
        "option": [
          "-e"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "vram",
        "label": "Estimate vRAM for model",
        "description": "An Ollama model (name:tag) or a HuggingFace ID (author/name).",
        "type": "string",
        "option": [
          "--vram"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "fits",
        "label": "Memory available (GB)",
        "description": "Find the best quantisation that fits this much memory.",
        "type": "number",
        "option": [
          "--fits"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "quant",
        "label": "Quantisation override",
        "type": "string",
        "option": [
          "--quant"
        ],
        "suggestions": [
          {
            "value": "Q4_0",
            "label": "Q4_0"
          },
          {
            "value": "Q5_K_M",
            "label": "Q5_K_M"
          }
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "log_level",
        "label": "Log level",
        "type": "enum",
        "option": [
          "--log-level"
        ],
        "choices": [
          {
            "value": "debug",
            "label": "Debug"
          },
          {
            "value": "info",
            "label": "Info"
          },
          {
            "value": "warn",
            "label": "Warn"
          },
          {
            "value": "error",
            "label": "Error"
          }
        ],
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "list",
        "label": "List models",
        "fields": [
          "list"
        ],
        "required": [
          "list"
        ],
        "set": {
          "list": [
            true
          ]
        }
      },
      {
        "id": "search",
        "label": "Search models",
        "fields": [
          "search"
        ],
        "required": [
          "search"
        ]
      },
      {
        "id": "vram",
        "label": "Estimate vRAM",
        "fields": [
          "vram",
          "fits",
          "quant"
        ],
        "required": [
          "vram"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "list",
          "search",
          "edit",
          "vram",
          "fits"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "quant",
          "log_level"
        ]
      }
    ]
  }
}