clonebox 0.1.23__tar.gz → 0.1.25__tar.gz

{clonebox-0.1.23/src/clonebox.egg-info → clonebox-0.1.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.23
+Version: 0.1.25
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -82,6 +82,9 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - ⚡ **Fast creation** - No full disk cloning, VMs are ready in seconds
 - 📥 **Auto-download** - Automatically downloads and caches Ubuntu cloud images (stored in ~/Downloads)
 - 📊 **Health monitoring** - Built-in health checks for packages, services, and mounts
+- 🔄 **Self-healing** - Automatic monitoring and repair of apps and services
+- 📈 **Live monitoring** - Real-time dashboard for running applications and services
+- 🔧 **Repair tools** - One-click fix for common VM issues (audio, permissions, mounts)
 - 🔄 **VM migration** - Export/import VMs with data between workstations
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
@@ -97,10 +100,12 @@ CloneBox excels in scenarios where developers need:
 ## What's Next
 
 Project roadmap includes:
-- Container runtime integration (Podman/Docker lightweight mode)
-- Local dashboard for VM and container management
-- Profile system for reusable configuration presets
-- Proxmox export capabilities for production migration
+- **v0.2.0**: `clonebox exec` command, VM snapshots, web dashboard MVP
+- **v0.3.0**: Container runtime integration (Podman/Docker), multi-VM orchestration
+- **v0.4.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
+- **v1.0.0**: Production-ready with full monitoring, backup/restore, enterprise features
+
+See [TODO.md](TODO.md) for detailed roadmap and [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
 
 
@@ -112,6 +117,8 @@ Kluczowe komendy:
 - `clonebox` – interaktywny wizard (detect + create + start)
 - `clonebox detect` – skanuje usługi/apps/ścieżki
 - `clonebox clone . --user --run` – szybki klon bieżącego katalogu z użytkownikiem i autostartem
+- `clonebox watch . --user` – monitoruj na żywo aplikacje i usługi w VM
+- `clonebox repair . --user` – napraw problemy z uprawnieniami, audio, usługami
 - `clonebox container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
 - `clonebox dashboard` – lokalny dashboard (VM + containers)
 
@@ -497,6 +504,111 @@ clonebox status . --user --health
 # Or rebuild: clonebox clone . --user --run --replace
 ```
 
+## 📊 Monitoring and Self-Healing
+
+CloneBox includes continuous monitoring and automatic self-healing capabilities for both GUI applications and system services.
+
+### Monitor Running Applications and Services
+
+```bash
+# Watch real-time status of apps and services
+clonebox watch . --user
+
+# Output shows live dashboard:
+# ╔══════════════════════════════════════════════════════════╗
+# ║                   CloneBox Live Monitor                  ║
+# ╠══════════════════════════════════════════════════════════╣
+# ║ 🖥️  GUI Apps:                                              ║
+# ║   ✅ pycharm-community    PID: 1234   Memory: 512MB       ║
+# ║   ✅ firefox             PID: 5678   Memory: 256MB       ║
+# ║   ❌ chromium            Not running                    ║
+# ║                                                          ║
+# ║ 🔧 System Services:                                       ║
+# ║   ✅ docker              Active: 2h 15m                ║
+# ║   ✅ nginx               Active: 1h 30m                ║
+# ║   ✅ uvicorn             Active: 45m (port 8000)       ║
+# ║                                                          ║
+# ║ 📊 Last check: 2024-01-31 13:25:30                       ║
+# ║ 🔄 Next check in: 25 seconds                             ║
+# ╚══════════════════════════════════════════════════════════╝
+
+# Check detailed status with logs
+clonebox status . --user --verbose
+
+# View monitor logs from host
+./scripts/clonebox-logs.sh  # Interactive log viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -f /var/log/clonebox-monitor.log"
+```
+
+### Repair and Troubleshooting
+
+```bash
+# Run automatic repair from host
+clonebox repair . --user
+
+# This triggers the repair script inside VM which:
+# - Fixes directory permissions (pulse, ibus, dconf)
+# - Restarts audio services (PulseAudio/PipeWire)
+# - Reconnects snap interfaces
+# - Remounts missing filesystems
+# - Resets GNOME keyring if needed
+
+# Interactive repair menu (via SSH)
+ssh ubuntu@<IP_VM> "clonebox-repair"
+
+# Manual repair options from host:
+clonebox repair . --user --auto      # Full automatic repair
+clonebox repair . --user --perms     # Fix permissions only
+clonebox repair . --user --audio     # Fix audio only
+clonebox repair . --user --snaps     # Reconnect snaps only
+clonebox repair . --user --mounts    # Remount filesystems only
+
+# Check repair status (via SSH)
+ssh ubuntu@<IP_VM> "cat /var/run/clonebox-status"
+
+# View repair logs
+./scripts/clonebox-logs.sh  # Interactive viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -n 50 /var/log/clonebox-boot.log"
+```
+
+### Monitor Configuration
+
+The monitoring system is configured through environment variables in `.env`:
+
+```bash
+# Enable/disable monitoring
+CLONEBOX_ENABLE_MONITORING=true
+CLONEBOX_MONITOR_INTERVAL=30      # Check every 30 seconds
+CLONEBOX_AUTO_REPAIR=true         # Auto-restart failed services
+CLONEBOX_WATCH_APPS=true          # Monitor GUI apps
+CLONEBOX_WATCH_SERVICES=true      # Monitor system services
+```
+
+### Inside the VM - Manual Controls
+
+```bash
+# Check monitor service status
+systemctl --user status clonebox-monitor
+
+# View monitor logs
+journalctl --user -u clonebox-monitor -f
+tail -f /var/log/clonebox-monitor.log
+
+# Stop/start monitoring
+systemctl --user stop clonebox-monitor
+systemctl --user start clonebox-monitor
+
+# Check last status
+cat /var/run/clonebox-monitor-status
+
+# Run repair manually
+clonebox-repair --all             # Run all fixes
+clonebox-repair --status          # Show current status
+clonebox-repair --logs            # Show recent logs
+```
+
 ### Export/Import Workflow
 
 ```bash
@@ -537,6 +649,13 @@ virt-viewer --connect qemu:///session clone-clonebox
 # Check VM details:
 clonebox list              # List all VMs
 virsh --connect qemu:///session dominfo clone-clonebox
+
+# Restart VM if needed:
+clonebox restart . --user  # Easiest - stop and start
+clonebox stop . --user && clonebox start . --user  # Manual restart
+clonebox restart . --user --open  # Restart and open GUI
+virsh --connect qemu:///session reboot clone-clonebox  # Direct reboot
+virsh --connect qemu:///session reset clone-clonebox  # Hard reset if frozen
 ```
 
 ## Legacy Examples (Manual Config)

{clonebox-0.1.23 → clonebox-0.1.25}/README.md

@@ -33,6 +33,9 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - ⚡ **Fast creation** - No full disk cloning, VMs are ready in seconds
 - 📥 **Auto-download** - Automatically downloads and caches Ubuntu cloud images (stored in ~/Downloads)
 - 📊 **Health monitoring** - Built-in health checks for packages, services, and mounts
+- 🔄 **Self-healing** - Automatic monitoring and repair of apps and services
+- 📈 **Live monitoring** - Real-time dashboard for running applications and services
+- 🔧 **Repair tools** - One-click fix for common VM issues (audio, permissions, mounts)
 - 🔄 **VM migration** - Export/import VMs with data between workstations
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
@@ -48,10 +51,12 @@ CloneBox excels in scenarios where developers need:
 ## What's Next
 
 Project roadmap includes:
-- Container runtime integration (Podman/Docker lightweight mode)
-- Local dashboard for VM and container management
-- Profile system for reusable configuration presets
-- Proxmox export capabilities for production migration
+- **v0.2.0**: `clonebox exec` command, VM snapshots, web dashboard MVP
+- **v0.3.0**: Container runtime integration (Podman/Docker), multi-VM orchestration
+- **v0.4.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
+- **v1.0.0**: Production-ready with full monitoring, backup/restore, enterprise features
+
+See [TODO.md](TODO.md) for detailed roadmap and [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
 
 
@@ -63,6 +68,8 @@ Kluczowe komendy:
 - `clonebox` – interaktywny wizard (detect + create + start)
 - `clonebox detect` – skanuje usługi/apps/ścieżki
 - `clonebox clone . --user --run` – szybki klon bieżącego katalogu z użytkownikiem i autostartem
+- `clonebox watch . --user` – monitoruj na żywo aplikacje i usługi w VM
+- `clonebox repair . --user` – napraw problemy z uprawnieniami, audio, usługami
 - `clonebox container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
 - `clonebox dashboard` – lokalny dashboard (VM + containers)
 
@@ -448,6 +455,111 @@ clonebox status . --user --health
 # Or rebuild: clonebox clone . --user --run --replace
 ```
 
+## 📊 Monitoring and Self-Healing
+
+CloneBox includes continuous monitoring and automatic self-healing capabilities for both GUI applications and system services.
+
+### Monitor Running Applications and Services
+
+```bash
+# Watch real-time status of apps and services
+clonebox watch . --user
+
+# Output shows live dashboard:
+# ╔══════════════════════════════════════════════════════════╗
+# ║                   CloneBox Live Monitor                  ║
+# ╠══════════════════════════════════════════════════════════╣
+# ║ 🖥️  GUI Apps:                                              ║
+# ║   ✅ pycharm-community    PID: 1234   Memory: 512MB       ║
+# ║   ✅ firefox             PID: 5678   Memory: 256MB       ║
+# ║   ❌ chromium            Not running                    ║
+# ║                                                          ║
+# ║ 🔧 System Services:                                       ║
+# ║   ✅ docker              Active: 2h 15m                ║
+# ║   ✅ nginx               Active: 1h 30m                ║
+# ║   ✅ uvicorn             Active: 45m (port 8000)       ║
+# ║                                                          ║
+# ║ 📊 Last check: 2024-01-31 13:25:30                       ║
+# ║ 🔄 Next check in: 25 seconds                             ║
+# ╚══════════════════════════════════════════════════════════╝
+
+# Check detailed status with logs
+clonebox status . --user --verbose
+
+# View monitor logs from host
+./scripts/clonebox-logs.sh  # Interactive log viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -f /var/log/clonebox-monitor.log"
+```
+
+### Repair and Troubleshooting
+
+```bash
+# Run automatic repair from host
+clonebox repair . --user
+
+# This triggers the repair script inside VM which:
+# - Fixes directory permissions (pulse, ibus, dconf)
+# - Restarts audio services (PulseAudio/PipeWire)
+# - Reconnects snap interfaces
+# - Remounts missing filesystems
+# - Resets GNOME keyring if needed
+
+# Interactive repair menu (via SSH)
+ssh ubuntu@<IP_VM> "clonebox-repair"
+
+# Manual repair options from host:
+clonebox repair . --user --auto      # Full automatic repair
+clonebox repair . --user --perms     # Fix permissions only
+clonebox repair . --user --audio     # Fix audio only
+clonebox repair . --user --snaps     # Reconnect snaps only
+clonebox repair . --user --mounts    # Remount filesystems only
+
+# Check repair status (via SSH)
+ssh ubuntu@<IP_VM> "cat /var/run/clonebox-status"
+
+# View repair logs
+./scripts/clonebox-logs.sh  # Interactive viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -n 50 /var/log/clonebox-boot.log"
+```
+
+### Monitor Configuration
+
+The monitoring system is configured through environment variables in `.env`:
+
+```bash
+# Enable/disable monitoring
+CLONEBOX_ENABLE_MONITORING=true
+CLONEBOX_MONITOR_INTERVAL=30      # Check every 30 seconds
+CLONEBOX_AUTO_REPAIR=true         # Auto-restart failed services
+CLONEBOX_WATCH_APPS=true          # Monitor GUI apps
+CLONEBOX_WATCH_SERVICES=true      # Monitor system services
+```
+
+### Inside the VM - Manual Controls
+
+```bash
+# Check monitor service status
+systemctl --user status clonebox-monitor
+
+# View monitor logs
+journalctl --user -u clonebox-monitor -f
+tail -f /var/log/clonebox-monitor.log
+
+# Stop/start monitoring
+systemctl --user stop clonebox-monitor
+systemctl --user start clonebox-monitor
+
+# Check last status
+cat /var/run/clonebox-monitor-status
+
+# Run repair manually
+clonebox-repair --all             # Run all fixes
+clonebox-repair --status          # Show current status
+clonebox-repair --logs            # Show recent logs
+```
+
 ### Export/Import Workflow
 
 ```bash
@@ -488,6 +600,13 @@ virt-viewer --connect qemu:///session clone-clonebox
 # Check VM details:
 clonebox list              # List all VMs
 virsh --connect qemu:///session dominfo clone-clonebox
+
+# Restart VM if needed:
+clonebox restart . --user  # Easiest - stop and start
+clonebox stop . --user && clonebox start . --user  # Manual restart
+clonebox restart . --user --open  # Restart and open GUI
+virsh --connect qemu:///session reboot clone-clonebox  # Direct reboot
+virsh --connect qemu:///session reset clone-clonebox  # Hard reset if frozen
 ```
 
 ## Legacy Examples (Manual Config)

{clonebox-0.1.23 → clonebox-0.1.25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clonebox"
-version = "0.1.23"
+version = "0.1.25"
 description = "Clone your workstation environment to an isolated VM with selective apps, paths and services"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{clonebox-0.1.23 → clonebox-0.1.25}/src/clonebox/cli.py

@@ -1007,6 +1007,39 @@ def cmd_stop(args):
     cloner.stop_vm(name, force=args.force, console=console)
 
 
+def cmd_restart(args):
+    """Restart a VM (stop and start)."""
+    name = args.name
+    
+    # If name is a path, load config
+    if name and (name.startswith(".") or name.startswith("/") or name.startswith("~")):
+        target_path = Path(name).expanduser().resolve()
+        config_file = target_path / ".clonebox.yaml" if target_path.is_dir() else target_path
+        if config_file.exists():
+            config = load_clonebox_config(config_file)
+            name = config["vm"]["name"]
+        else:
+            console.print(f"[red]❌ Config not found: {config_file}[/]")
+            return
+    
+    cloner = SelectiveVMCloner(user_session=getattr(args, "user", False))
+    
+    # Stop the VM
+    console.print("[bold yellow]🔄 Stopping VM...[/]")
+    cloner.stop_vm(name, force=args.force, console=console)
+    
+    # Wait a moment
+    time.sleep(2)
+    
+    # Start the VM
+    console.print("[bold green]🚀 Starting VM...[/]")
+    cloner.start_vm(name, wait_for_agent=True, console=console)
+    
+    console.print("[bold green]✅ VM restarted successfully![/]")
+    if getattr(args, "open", False):
+        cloner.open_gui(name, console=console)
+
+
 def cmd_delete(args):
     """Delete a VM."""
     name = args.name
@@ -2521,6 +2554,28 @@ def main():
     )
     stop_parser.set_defaults(func=cmd_stop)
 
+    # Restart command
+    restart_parser = subparsers.add_parser("restart", help="Restart a VM (stop and start)")
+    restart_parser.add_argument("name", nargs="?", default=None, help="VM name or '.' to use .clonebox.yaml")
+    restart_parser.add_argument(
+        "-f",
+        "--force",
+        action="store_true",
+        help="Force stop if VM is stuck",
+    )
+    restart_parser.add_argument(
+        "-u",
+        "--user",
+        action="store_true",
+        help="Use user session (qemu:///session) - no root required",
+    )
+    restart_parser.add_argument(
+        "--open",
+        action="store_true",
+        help="Open GUI after restart",
+    )
+    restart_parser.set_defaults(func=cmd_restart)
+
     # Delete command
     delete_parser = subparsers.add_parser("delete", help="Delete a VM")
     delete_parser.add_argument("name", nargs="?", default=None, help="VM name or '.' to use .clonebox.yaml")

{clonebox-0.1.23 → clonebox-0.1.25}/src/clonebox/cloner.py

@@ -606,12 +606,76 @@ connect_interfaces() {{
 }}
 
 test_launch() {{
-    case "$1" in
-        pycharm-community) /snap/pycharm-community/current/jbr/bin/java -version &>/dev/null ;;
-        chromium) timeout 10 chromium --headless=new --dump-dom about:blank &>/dev/null ;;
-        firefox) timeout 10 firefox --headless --screenshot /tmp/ff-test.png about:blank &>/dev/null; rm -f /tmp/ff-test.png ;;
-        docker) docker info &>/dev/null ;;
-        *) command -v "$1" &>/dev/null ;;
+    local app="$1"
+    local temp_output="/tmp/$app-test.log"
+    local error_detail="/tmp/$app-error.log"
+    
+    case "$app" in
+        pycharm-community) 
+            if timeout 10 /snap/pycharm-community/current/jbr/bin/java -version &>"$temp_output"; then
+                return 0
+            else
+                echo "PyCharm Java test failed:" >> "$error_detail"
+                cat "$temp_output" >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        chromium) 
+            # First check if chromium can run at all
+            if ! command -v chromium >/dev/null 2>&1; then
+                echo "ERROR: chromium not found in PATH" >> "$error_detail"
+                echo "PATH=$PATH" >> "$error_detail"
+                return 1
+            fi
+            
+            # Try with different approaches
+            if timeout 10 chromium --headless=new --dump-dom about:blank &>"$temp_output" 2>&1; then
+                return 0
+            else
+                echo "Chromium headless test failed:" >> "$error_detail"
+                cat "$temp_output" >> "$error_detail"
+                
+                # Try basic version check
+                echo "Trying chromium --version:" >> "$error_detail"
+                timeout 5 chromium --version >> "$error_detail" 2>&1 || true
+                
+                # Check display
+                echo "Display check:" >> "$error_detail"
+                echo "DISPLAY=${{DISPLAY:-unset}}" >> "$error_detail"
+                echo "XDG_RUNTIME_DIR=${{XDG_RUNTIME_DIR:-unset}}" >> "$error_detail"
+                ls -la /tmp/.X11-unix/ >> "$error_detail" 2>&1 || true
+                
+                return 1
+            fi
+            ;;
+        firefox) 
+            if timeout 10 firefox --headless --screenshot /tmp/ff-test.png about:blank &>/dev/null; then
+                rm -f /tmp/ff-test.png
+                return 0
+            else
+                echo "Firefox headless test failed" >> "$error_detail"
+                timeout 5 firefox --version >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        docker) 
+            if docker info &>/dev/null; then
+                return 0
+            else
+                echo "Docker info failed:" >> "$error_detail"
+                docker info >> "$error_detail" 2>&1 || true
+                return 1
+            fi
+            ;;
+        *) 
+            if command -v "$1" &>/dev/null; then
+                return 0
+            else
+                echo "Command not found: $1" >> "$error_detail"
+                echo "PATH=$PATH" >> "$error_detail"
+                return 1
+            fi
+            ;;
     esac
 }}
 
@@ -751,6 +815,11 @@ for app in "${{APPS_TO_TEST[@]}}"; do
         ok "$app launches OK"
     else
         fail "$app launch test FAILED"
+        # Show error details in main log
+        if [ -f "/tmp/$app-error.log" ]; then
+            echo "  Error details:" | tee -a "$LOG"
+            head -10 "/tmp/$app-error.log" | sed 's/^/    /' | tee -a "$LOG" || true
+        fi
     fi
 done
 
@@ -1481,6 +1550,15 @@ esac
         # Enable lingering for the user (allows user services to run without login)
         runcmd_lines.append(f"  - loginctl enable-linger {config.username}")
         
+        # Add environment variables for monitoring
+        runcmd_lines.extend([
+            "  - echo 'CLONEBOX_ENABLE_MONITORING=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_MONITOR_INTERVAL=30' >> /etc/environment",
+            "  - echo 'CLONEBOX_AUTO_REPAIR=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_WATCH_APPS=true' >> /etc/environment",
+            "  - echo 'CLONEBOX_WATCH_SERVICES=true' >> /etc/environment",
+        ])
+        
         # Generate autostart configurations based on installed apps (if enabled)
         autostart_apps = []
         
@@ -1627,7 +1705,69 @@ WantedBy=multi-user.target
             runcmd_lines.append(f"  - systemctl enable {svc_name}.service")
             runcmd_lines.append(f"  - systemctl start {svc_name}.service || true")
         
-        # Create Python monitor service for continuous diagnostics
+        # Install CloneBox Monitor for continuous monitoring and self-healing
+        scripts_dir = Path(__file__).resolve().parent.parent.parent / "scripts"
+        try:
+            with open(scripts_dir / "clonebox-monitor.sh") as f:
+                monitor_script = f.read()
+            with open(scripts_dir / "clonebox-monitor.service") as f:
+                monitor_service = f.read()
+            with open(scripts_dir / "clonebox-monitor.default") as f:
+                monitor_config = f.read()
+        except (FileNotFoundError, OSError):
+            # Fallback to embedded scripts if files not found
+            monitor_script = '''#!/bin/bash
+# CloneBox Monitor - Fallback embedded version
+set -euo pipefail
+LOG_FILE="/var/log/clonebox-monitor.log"
+log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"; }
+log_info() { log "[INFO] $1"; }
+log_warn() { log "[WARN] $1"; }
+log_error() { log "[ERROR] $1"; }
+log_success() { log "[SUCCESS] $1"; }
+while true; do
+    log_info "CloneBox Monitor running..."
+    sleep 60
+done
+'''
+            monitor_service = '''[Unit]
+Description=CloneBox Monitor
+After=graphical-session.target
+[Service]
+Type=simple
+User=ubuntu
+ExecStart=/usr/local/bin/clonebox-monitor
+Restart=always
+[Install]
+WantedBy=default.target
+'''
+            monitor_config = '''# CloneBox Monitor Configuration
+CLONEBOX_MONITOR_INTERVAL=30
+CLONEBOX_AUTO_REPAIR=true
+'''
+        
+        # Install monitor script
+        monitor_b64 = base64.b64encode(monitor_script.encode()).decode()
+        runcmd_lines.append(f"  - echo '{monitor_b64}' | base64 -d > /usr/local/bin/clonebox-monitor")
+        runcmd_lines.append("  - chmod +x /usr/local/bin/clonebox-monitor")
+        
+        # Install monitor configuration
+        config_b64 = base64.b64encode(monitor_config.encode()).decode()
+        runcmd_lines.append(f"  - echo '{config_b64}' | base64 -d > /etc/default/clonebox-monitor")
+        
+        # Install systemd user service
+        service_b64 = base64.b64encode(monitor_service.encode()).decode()
+        runcmd_lines.append(f"  - echo '{service_b64}' | base64 -d > /etc/systemd/user/clonebox-monitor.service")
+        
+        # Enable lingering and start monitor
+        runcmd_lines.extend([
+            "  - loginctl enable-linger ubuntu",
+            "  - sudo -u ubuntu systemctl --user daemon-reload",
+            "  - sudo -u ubuntu systemctl --user enable clonebox-monitor.service",
+            "  - sudo -u ubuntu systemctl --user start clonebox-monitor.service || true",
+        ])
+        
+        # Create Python monitor service for continuous diagnostics (legacy)
         monitor_script = f'''#!/usr/bin/env python3
 """CloneBox Monitor - Continuous diagnostics and app restart service."""
 import subprocess
@@ -1729,28 +1869,22 @@ def main():
 if __name__ == "__main__":
     main()
 '''
-        monitor_b64 = base64.b64encode(monitor_script.encode()).decode()
-        runcmd_lines.append(f"  - echo '{monitor_b64}' | base64 -d > /usr/local/bin/clonebox-monitor")
-        runcmd_lines.append("  - chmod +x /usr/local/bin/clonebox-monitor")
+        # Note: The bash monitor is already installed above, no need to install Python monitor
         
-        # Create systemd service for the Python monitor
-        monitor_service = '''[Unit]
-Description=CloneBox Monitor Service
-After=network.target graphical.target
-
-[Service]
-Type=simple
-ExecStart=/usr/bin/python3 /usr/local/bin/clonebox-monitor
-Restart=always
-RestartSec=30
-
-[Install]
-WantedBy=multi-user.target'''
-        monitor_svc_b64 = base64.b64encode(monitor_service.encode()).decode()
-        runcmd_lines.append(f"  - echo '{monitor_svc_b64}' | base64 -d > /etc/systemd/system/clonebox-monitor.service")
-        runcmd_lines.append("  - systemctl daemon-reload")
-        runcmd_lines.append("  - systemctl enable clonebox-monitor.service")
-        runcmd_lines.append("  - systemctl start clonebox-monitor.service || true")
+        # Create logs disk for host access
+        runcmd_lines.extend([
+            "  - mkdir -p /mnt/logs",
+            "  - truncate -s 1G /var/lib/libvirt/images/clonebox-logs.qcow2",
+            "  - mkfs.ext4 -F /var/lib/libvirt/images/clonebox-logs.qcow2",
+            "  - echo '/var/lib/libvirt/images/clonebox-logs.qcow2 /mnt/logs ext4 loop,defaults 0 0' >> /etc/fstab",
+            "  - mount -a",
+            "  - mkdir -p /mnt/logs/var/log",
+            "  - mkdir -p /mnt/logs/tmp",
+            "  - cp -r /var/log/clonebox*.log /mnt/logs/var/log/ 2>/dev/null || true",
+            "  - cp -r /tmp/*-error.log /mnt/logs/tmp/ 2>/dev/null || true",
+            "  - echo 'Logs disk mounted at /mnt/logs - accessible from host as /var/lib/libvirt/images/clonebox-logs.qcow2'",
+            "  - echo 'To view logs on host: sudo mount -o loop /var/lib/libvirt/images/clonebox-logs.qcow2 /mnt/clonebox-logs'",
+        ])
         
         # Add reboot command at the end if GUI is enabled
         if config.gui:

{clonebox-0.1.23 → clonebox-0.1.25/src/clonebox.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.23
+Version: 0.1.25
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -82,6 +82,9 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - ⚡ **Fast creation** - No full disk cloning, VMs are ready in seconds
 - 📥 **Auto-download** - Automatically downloads and caches Ubuntu cloud images (stored in ~/Downloads)
 - 📊 **Health monitoring** - Built-in health checks for packages, services, and mounts
+- 🔄 **Self-healing** - Automatic monitoring and repair of apps and services
+- 📈 **Live monitoring** - Real-time dashboard for running applications and services
+- 🔧 **Repair tools** - One-click fix for common VM issues (audio, permissions, mounts)
 - 🔄 **VM migration** - Export/import VMs with data between workstations
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
@@ -97,10 +100,12 @@ CloneBox excels in scenarios where developers need:
 ## What's Next
 
 Project roadmap includes:
-- Container runtime integration (Podman/Docker lightweight mode)
-- Local dashboard for VM and container management
-- Profile system for reusable configuration presets
-- Proxmox export capabilities for production migration
+- **v0.2.0**: `clonebox exec` command, VM snapshots, web dashboard MVP
+- **v0.3.0**: Container runtime integration (Podman/Docker), multi-VM orchestration
+- **v0.4.0**: Cloud provider support (AWS, GCP, Azure), Windows WSL2 support
+- **v1.0.0**: Production-ready with full monitoring, backup/restore, enterprise features
+
+See [TODO.md](TODO.md) for detailed roadmap and [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
 
 
@@ -112,6 +117,8 @@ Kluczowe komendy:
 - `clonebox` – interaktywny wizard (detect + create + start)
 - `clonebox detect` – skanuje usługi/apps/ścieżki
 - `clonebox clone . --user --run` – szybki klon bieżącego katalogu z użytkownikiem i autostartem
+- `clonebox watch . --user` – monitoruj na żywo aplikacje i usługi w VM
+- `clonebox repair . --user` – napraw problemy z uprawnieniami, audio, usługami
 - `clonebox container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
 - `clonebox dashboard` – lokalny dashboard (VM + containers)
 
@@ -497,6 +504,111 @@ clonebox status . --user --health
 # Or rebuild: clonebox clone . --user --run --replace
 ```
 
+## 📊 Monitoring and Self-Healing
+
+CloneBox includes continuous monitoring and automatic self-healing capabilities for both GUI applications and system services.
+
+### Monitor Running Applications and Services
+
+```bash
+# Watch real-time status of apps and services
+clonebox watch . --user
+
+# Output shows live dashboard:
+# ╔══════════════════════════════════════════════════════════╗
+# ║                   CloneBox Live Monitor                  ║
+# ╠══════════════════════════════════════════════════════════╣
+# ║ 🖥️  GUI Apps:                                              ║
+# ║   ✅ pycharm-community    PID: 1234   Memory: 512MB       ║
+# ║   ✅ firefox             PID: 5678   Memory: 256MB       ║
+# ║   ❌ chromium            Not running                    ║
+# ║                                                          ║
+# ║ 🔧 System Services:                                       ║
+# ║   ✅ docker              Active: 2h 15m                ║
+# ║   ✅ nginx               Active: 1h 30m                ║
+# ║   ✅ uvicorn             Active: 45m (port 8000)       ║
+# ║                                                          ║
+# ║ 📊 Last check: 2024-01-31 13:25:30                       ║
+# ║ 🔄 Next check in: 25 seconds                             ║
+# ╚══════════════════════════════════════════════════════════╝
+
+# Check detailed status with logs
+clonebox status . --user --verbose
+
+# View monitor logs from host
+./scripts/clonebox-logs.sh  # Interactive log viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -f /var/log/clonebox-monitor.log"
+```
+
+### Repair and Troubleshooting
+
+```bash
+# Run automatic repair from host
+clonebox repair . --user
+
+# This triggers the repair script inside VM which:
+# - Fixes directory permissions (pulse, ibus, dconf)
+# - Restarts audio services (PulseAudio/PipeWire)
+# - Reconnects snap interfaces
+# - Remounts missing filesystems
+# - Resets GNOME keyring if needed
+
+# Interactive repair menu (via SSH)
+ssh ubuntu@<IP_VM> "clonebox-repair"
+
+# Manual repair options from host:
+clonebox repair . --user --auto      # Full automatic repair
+clonebox repair . --user --perms     # Fix permissions only
+clonebox repair . --user --audio     # Fix audio only
+clonebox repair . --user --snaps     # Reconnect snaps only
+clonebox repair . --user --mounts    # Remount filesystems only
+
+# Check repair status (via SSH)
+ssh ubuntu@<IP_VM> "cat /var/run/clonebox-status"
+
+# View repair logs
+./scripts/clonebox-logs.sh  # Interactive viewer
+# Or via SSH:
+ssh ubuntu@<IP_VM> "tail -n 50 /var/log/clonebox-boot.log"
+```
+
+### Monitor Configuration
+
+The monitoring system is configured through environment variables in `.env`:
+
+```bash
+# Enable/disable monitoring
+CLONEBOX_ENABLE_MONITORING=true
+CLONEBOX_MONITOR_INTERVAL=30      # Check every 30 seconds
+CLONEBOX_AUTO_REPAIR=true         # Auto-restart failed services
+CLONEBOX_WATCH_APPS=true          # Monitor GUI apps
+CLONEBOX_WATCH_SERVICES=true      # Monitor system services
+```
+
+### Inside the VM - Manual Controls
+
+```bash
+# Check monitor service status
+systemctl --user status clonebox-monitor
+
+# View monitor logs
+journalctl --user -u clonebox-monitor -f
+tail -f /var/log/clonebox-monitor.log
+
+# Stop/start monitoring
+systemctl --user stop clonebox-monitor
+systemctl --user start clonebox-monitor
+
+# Check last status
+cat /var/run/clonebox-monitor-status
+
+# Run repair manually
+clonebox-repair --all             # Run all fixes
+clonebox-repair --status          # Show current status
+clonebox-repair --logs            # Show recent logs
+```
+
 ### Export/Import Workflow
 
 ```bash
@@ -537,6 +649,13 @@ virt-viewer --connect qemu:///session clone-clonebox
 # Check VM details:
 clonebox list              # List all VMs
 virsh --connect qemu:///session dominfo clone-clonebox
+
+# Restart VM if needed:
+clonebox restart . --user  # Easiest - stop and start
+clonebox stop . --user && clonebox start . --user  # Manual restart
+clonebox restart . --user --open  # Restart and open GUI
+virsh --connect qemu:///session reboot clone-clonebox  # Direct reboot
+virsh --connect qemu:///session reset clone-clonebox  # Hard reset if frozen
 ```
 
 ## Legacy Examples (Manual Config)