{
  "markdown": "<!-- mcp-name: io.github.vmware-skills/vmware-debug -->\n\n# VMware Debug\n\n> ⚠️ **Work in progress** — the core (event correlation engine, MCP tools, CLI)\n> is built and tested; README, `server.json`, full reference docs, and packaging\n> polish are still landing. Not yet published to PyPI.\n\n> **Disclaimer**: Community-maintained open-source project, **not affiliated with,\n> endorsed by, or sponsored by VMware, Inc. or Broadcom Inc.** \"VMware\" and\n> \"vSphere\" are trademarks of Broadcom. Source is publicly auditable under the MIT\n> license.\n\nThe diagnostic brain of the VMware skill family. You bring the symptom (an error,\na log dump, a slow VM); this skill runs a systematic investigation, correlates\nevents from the other skills into one timeline, ranks root-cause hypotheses, and\ntells you what to check next. It is **read-only** — it never changes anything and\nnever executes fixes. Remediation is routed to `vmware-aiops` (single op) or\n`vmware-pilot` (multi-step, gated), mirroring the `vmware-harden → vmware-pilot`\nadvisor/executor split.\n\nSee [`skills/vmware-debug/SKILL.md`](skills/vmware-debug/SKILL.md) for the full\nmethodology, the event-envelope contract, and symptom routing.\n\n## MCP tools\n\n| Tool | What |\n|---|---|\n| `incident_timeline` | [READ] Correlate pre-fetched events → timeline + spikes + ranked hypotheses + next-check ideas |\n| `list_symptom_categories` | [READ] List recognised symptom categories + what to check for each |\n\n## Offline / Air-Gapped Install (from source)\n\nThis project uses the modern PEP 517 build system (hatchling), so there is **no\n`setup.py`** by design — that is expected, not a missing file. If you cloned the\nsource and hit `ERROR: File \"setup.py\" or \"setup.cfg\" not found ... editable mode\ncurrently requires a setuptools-based build`, your `pip` is older than 21.3 and\ncannot do an *editable* (`-e`) install with a non-setuptools backend. Editable\nmode is a developer convenience, not needed to run the tool — do one of:\n\n```bash\n# From the source tree — a normal (non-editable) install builds a wheel:\npip install .              # NOT  pip install -e .\n\n# ...or upgrade pip first, and editable works too:\npip install --upgrade pip && pip install -e .\n```\n\nFor a **truly air-gapped host**, build the wheels on a connected machine and copy\nthem over — the target then needs no network:\n\n```bash\n# On a connected machine, collect this package + its dependencies as wheels:\npip wheel . -w dist        # → dist/*.whl   (or: uv build, for just this package)\n\n# Copy dist/ to the air-gapped host, then install offline:\npip install --no-index --find-links dist vmware-debug\n```\n\n## License\n\nMIT.\n",
  "bytes": 2646,
  "sha": "e9bb3aeeb75860a624a4f1f63910d866cb7d3e9b3e112531969875d919bf1298",
  "repo_slug": "vmware-skills/vmware-debug",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vmware_skills_vmware_debug_022ec556/readme"
}