.

README.MD

@@ -0,0 +1,54 @@
+# Killguest
+
+`killguest` ist ein kleines Shell-Tool für Proxmox VE, um hängende VMs oder LXC-Container zuverlässig zu beenden, 
+wenn Standardbefehle wie `qm stop` oder `pct stop` versagen.
+
+## Features
+
+-   Automatische Erkennung (VM oder LXC)
+-   Anzeige von ID, Name, Typ und Prozesse `bevor` beendet wird
+
+## Installation
+
+```bash
+nano /usr/local/bin/killguest
+chmod +x /usr/local/bin/killguest
+```
+
+## Nutzung
+
+    killguest <ID>
+
+Beispiele:
+
+    killguest 125
+    killguest 201
+
+## Funktionsweise
+
+### VM
+
+Findet den QEMU-Prozess:
+
+    /usr/bin/kvm -id <vmid>
+
+und beendet ihn mit:
+
+    kill -9 <PID>
+
+### LXC
+
+Findet Prozesse über cgroups:
+
+    /proc/*/cgroup → lxc/<ctid>
+
+und beendet alle zugehörigen Prozesse.
+
+## Warnung
+
+Dieses Tool führt einen Hard-Stop durch (wie Strom ziehen). Nur
+verwenden, wenn normale Stop-Befehle nicht funktionieren.
+
+## Fazit
+
+killguest ist ein Notfall-Tool für hartnäckige Hänger in Proxmox.