unraid-assistant

Generate cloud-init configuration for unattended VM provisioning on Unraid

Generate an Unraid Docker XML template for a container

Scaffold a Terraform configuration for Unraid VM provisioning

Generate a libvirt VM domain XML file for Unraid

Use this agent when diagnosing Unraid server problems, investigating VM or Docker failures, debugging array issues, or troubleshooting system performance. Examples: <example> Context: User reports a VM won't start user: "My Windows VM won't start, it was working yesterday" assistant: "Let me use the unraid-troubleshooter to investigate the VM issue" <commentary> VM startup failure requires checking VM state, system resources, and potential conflicts like GPU passthrough issues. </commentary> </example> <example> Context: Docker container keeps crashing user: "My Plex container keeps restarting every few minutes" assistant: "I'll use the unraid-troubleshooter to diagnose the container restart loop" <commentary> Container restart loops need log analysis, resource checks, and configuration review. </commentary> </example> <example> Context: Array performance problem user: "Parity check is running really slow, it's been going for 3 days" assistant: "Let me have the unraid-troubleshooter investigate the slow parity check" <commentary> Slow parity checks can indicate disk issues, high I/O from other processes, or hardware problems. </commentary> </example>

Use when the user asks about Docker containers on Unraid, including templates, Docker Compose, container configuration, or Docker CLI operations. Examples: "docker template", "unraid docker", "container template xml", "docker compose unraid", "unraid container setup".

Use when the user asks about Terraform, Ansible, or infrastructure-as-code approaches for managing Unraid servers, VMs, or configuration. Examples: "terraform unraid", "ansible unraid", "infrastructure as code", "iac unraid", "terraform libvirt".

Use when the user asks about Unraid shell scripting, User Scripts plugin, event hooks, boot scripts, CLI tools, cron jobs, or system automation. Examples: "user scripts", "unraid script", "emhttp_event", "unraid boot config", "/boot/config/go", "unraid cron".

Use when the user asks about the Unraid GraphQL API, authentication, queries, mutations, subscriptions, or API keys. Examples: "unraid api", "graphql query", "unraid mutation", "api key setup", "unraid authentication".

Use when the user asks about creating, configuring, or cloning VMs on Unraid, including libvirt, virsh, cloud-init, GPU passthrough, or VFIO setup. Examples: "create vm", "provision vm", "gpu passthrough", "cloud-init unraid", "virsh commands".