Home

kvm-pilot documentation

Everything for using and developing kvm-pilot, in one place. This folder is the source of truth; the project wiki is an auto-generated, nicely formatted mirror of these pages (built by .github/workflows/wiki-sync.yml on every push to main — edit the files here, never the wiki directly).

Start here

• Overview, install, quickstart → README
• Release history → CHANGELOG

Guides

• Architecture — the driver-plugin design, capability protocols, and diagrams.
• Configuration — the config file, every KVM_PILOT_* env var, and precedence.
• Design decisions — the "looks wrong but is intentional" record, newest first.
• Redfish reference — the BMC driver: hypermedia navigation, auth, and firmware quirks.
• Claude skill — the bundled skill for driving kvm-pilot from Claude.
• MCP server — the experimental Model Context Protocol server.

Contributing & security

• Contributing — dev setup, the pre-PR checklist, and engineering principles.
• Security policy — reporting a vulnerability and operational guidance.