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

• New here? Drive a KVM from your agent → Getting started
• Overview, install, quickstart → README
• Release history → CHANGELOG

Guides

• Architecture — the driver-plugin design, capability protocols, and diagrams.
• CLI reference — every kvm-pilot subcommand: capability required, destructive gating, key flags.
• Configuration — the config file, every KVM_PILOT_* env var, and precedence.
• Design decisions — the "looks wrong but is intentional" record, newest first.
• Reflexes (RFC) — the post-GA edge-autonomy playbook runner: act locally on known steps, escalate surprises to the agent (#117).
• Redfish reference — the BMC driver: hypermedia navigation, auth, and firmware quirks.
• Firmware registry — the firmware-currency check, the community registry data model, and the GitHub-based single-source-of-truth + ingestion design (#80 follow-up).
• Remote firmware update — the GL /api/upgrade/* surface, the reliability/risk model, and the gated firmware-update command (#92).
• Unattended Linux installs — prefer text mode + SSH over driving a graphical installer via KVM HID: the per-distro boot-arg matrix (Anaconda inst.sshd/inst.text, d-i network-console, Subiquity autoinstall, linuxrc ssh=1) and the SSH handoff (#129).
• Claude skill — the bundled skill for driving kvm-pilot from Claude.
• MCP server — the bundled Model Context Protocol server (kvm-pilot-mcp).

Contributing & security

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

Analysis

Session-level review narratives — what was reviewed, how, what was found, and what changed. Individual judgment calls live in decisions.md; these are the stories around them.

• 2026-07-01 deep review — the top-to-bottom multi-agent review: 86 verified findings, 10 same-day fix commits, issues #37–#65, and the milestones that came out of it.