ov-layers/skills/qemu-guest-agent/SKILL.md
QEMU guest agent for host-guest communication in virtual machines. Use when working with QEMU/KVM VMs, guest agent setup, or libvirt channel configuration.
npx skillsauth add overthinkos/overthink-plugins qemu-guest-agentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
| Property | Value |
|----------|-------|
| Install files | layer.yml |
qemu-guest-agent (RPM) -- QEMU guest agent daemon# image.yml -- typically used via bootc-base composition
my-vm-image:
bootc: true
layers:
- bootc-base
Part of the bootc-base composition layer. Used transitively in bootc/VM images.
The layer contributes a raw libvirt XML snippet that the libvirt renderer places in the VM's <devices> section:
<channel type='unix'>
<target type='virtio' name='org.qemu.guest_agent.0'/>
</channel>
Emitted in layer.yml as:
libvirt:
snippets:
- "<channel type='unix'><target type='virtio' name='org.qemu.guest_agent.0'/></channel>"
This is the / classification case: isDeviceElement flags it as device-scoped, so the renderer injects it inside <devices> rather than before </domain>. See /ov-dev:libvirt-renderer for the injection pipeline and /ov:vm for the QEMU-user-net caveat (the agent shows as enabled/inactive under ov's QEMU backend; libvirt backend activates it).
/ov-layers:bootc-base -- composition that includes this layer/ov-layers:sshd -- SSH server (also in bootc-base)/ov-layers:bootc-config -- bootc system config (also in bootc-base)Use when the user asks about:
org.qemu.guest_agent.0 channel/ov:layer — layer authoring reference (layer.yml schema, task verbs, service declarations, libvirt.snippets:)/ov:vm — VM lifecycle; bootc VM caveats; QEMU-user-net limitation/ov-vms:vms — kind: vm entity schema that consumes this layer's contribution/ov-dev:libvirt-renderer — renderer that injects this layer's snippet into <devices>/ov:test — declarative testing (tests: block, ov image test, ov test)tools
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
development
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
tools
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
tools
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.