clonebox 0.1.20__tar.gz → 0.1.21__tar.gz

{clonebox-0.1.20/src/clonebox.egg-info → clonebox-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.20
+Version: 0.1.21
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -85,6 +85,22 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
 
+## Use Cases
+
+CloneBox excels in scenarios where developers need:
+- Isolated sandbox environments for testing AI agents, edge computing simulations, or integration workflows without risking host system stability
+- Reproducible development setups that can be quickly spun up with identical configurations across different machines
+- Safe experimentation with system-level changes that can be discarded by simply deleting the VM
+- Quick onboarding for new team members who need a fully configured development environment
+
+## 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
+
 
 
 
@@ -95,6 +111,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 container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
+- `clonebox dashboard` – lokalny dashboard (VM + containers)
 
 ### Dlaczego wirtualne klony workstation mają sens?
 
@@ -167,6 +185,11 @@ pip install -e .
 # Or directly
 pip install clonebox
 ```
+
+Dashboard ma opcjonalne zależności:
+```bash
+pip install "clonebox[dashboard]"
+```
 lub
 ```bash
 # Aktywuj venv
@@ -247,7 +270,34 @@ Simply run `clonebox` to start the interactive wizard:
 
 ```bash
 clonebox
-clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2
+
+clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2 --disk-size-gb 30
+
+clonebox test . --user --validate
+```
+
+### Profiles (Reusable presets)
+
+Profiles pozwalają trzymać gotowe presety dla VM/container (np. `ml-dev`, `web-dev`) i nakładać je na bazową konfigurację.
+
+```bash
+# Przykład: uruchom kontener z profilem
+clonebox container up . --profile ml-dev --engine podman
+
+# Przykład: generuj VM config z profilem
+clonebox clone . --profile ml-dev --user --run
+```
+
+Domyślne lokalizacje profili:
+- `~/.clonebox.d/<name>.yaml`
+- `./.clonebox.d/<name>.yaml`
+- wbudowane: `src/clonebox/templates/profiles/<name>.yaml`
+
+### Dashboard
+
+```bash
+clonebox dashboard --port 8080
+# http://127.0.0.1:8080
 ```
 
 The wizard will:
@@ -268,7 +318,10 @@ clonebox create --name my-dev-vm --config '{
   },
   "packages": ["python3", "nodejs", "docker.io"],
   "services": ["docker"]
-}' --ram 4096 --vcpus 4 --start
+}' --ram 4096 --vcpus 4 --disk-size-gb 20 --start
+
+# Create VM with larger root disk
+clonebox create --name my-dev-vm --disk-size-gb 30 --config '{"paths": {}, "packages": [], "services": []}'
 
 # List VMs
 clonebox list
@@ -325,10 +378,45 @@ clonebox clone . --user --run
 
 # Access in VM:
 ls ~/.config/google-chrome  # Chrome profile
-ls ~/.mozilla/firefox       # Firefox profile
-ls ~/.config/JetBrains      # PyCharm settings
+
+# Firefox profile (Ubuntu często używa snap):
+ls ~/snap/firefox/common/.mozilla/firefox
+ls ~/.mozilla/firefox
+
+# PyCharm profile (snap):
+ls ~/snap/pycharm-community/common/.config/JetBrains
+ls ~/.config/JetBrains
+```
+
+### Container workflow (podman/docker)
+
+```bash
+# Start a dev container (auto-detect engine if not specified)
+clonebox container up . --engine podman --detach
+
+# List running containers
+clonebox container ps
+
+# Stop/remove
+clonebox container stop <name>
+clonebox container rm <name>
+```
+
+### Full validation (VM)
+
+`clonebox test` weryfikuje, że VM faktycznie ma zamontowane ścieżki i spełnia wymagania z `.clonebox.yaml`.
+
+```bash
+clonebox test . --user --validate
 ```
 
+Walidowane kategorie:
+- **Mounts** (9p)
+- **Packages** (apt)
+- **Snap packages**
+- **Services** (enabled + running)
+- **Apps** (instalacja + dostępność profilu: Firefox/PyCharm/Chrome)
+
 ### Testing and Validating VM Configuration
 
 ```bash
@@ -557,6 +645,9 @@ The fastest way to clone your current working directory:
 # Base OS image is automatically downloaded to ~/Downloads on first run
 clonebox clone .
 
+# Increase VM disk size (recommended for GUI + large tooling)
+clonebox clone . --user --disk-size-gb 30
+
 # Clone specific path
 clonebox clone ~/projects/my-app
 
@@ -687,8 +778,10 @@ clonebox clone . --network auto
 | `clonebox clone . --replace` | Replace existing VM (stop, delete, recreate) |
 | `clonebox clone . --user` | Clone in user session (no root) |
 | `clonebox clone . --base-image <path>` | Use custom base image |
+| `clonebox clone . --disk-size-gb <gb>` | Set root disk size in GB (generated configs default to 20GB) |
 | `clonebox clone . --network user` | Use user-mode networking (slirp) |
 | `clonebox clone . --network auto` | Auto-detect network mode (default) |
+| `clonebox create --config <json> --disk-size-gb <gb>` | Create VM from JSON config with specified disk size |
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
@@ -701,6 +794,11 @@ clonebox clone . --network auto
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
+| `clonebox container up .` | Start a dev container for given path |
+| `clonebox container ps` | List containers |
+| `clonebox container stop <name>` | Stop a container |
+| `clonebox container rm <name>` | Remove a container |
+| `clonebox dashboard` | Run local dashboard (VM + containers) |
 | `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
 | `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration (basic checks) |
@@ -721,6 +819,97 @@ clonebox clone . --network auto
 
 ## Troubleshooting
 
+### Critical: Insufficient Disk Space
+
+If you install a full desktop environment and large development tools (e.g. `ubuntu-desktop-minimal`, `docker.io`, large snaps like `pycharm-community`/`chromium`), you may hit low disk space warnings inside the VM.
+
+Recommended fix:
+- Set a larger root disk in `.clonebox.yaml`:
+
+```yaml
+vm:
+  disk_size_gb: 30
+```
+
+You can also set it during config generation:
+```bash
+clonebox clone . --user --disk-size-gb 30
+```
+
+Notes:
+- New configs generated by `clonebox clone` default to `disk_size_gb: 20`.
+- You can override this by setting `vm.disk_size_gb` in `.clonebox.yaml`.
+
+Workaround for an existing VM (host-side resize + guest filesystem grow):
+```bash
+clonebox stop . --user
+qemu-img resize ~/.local/share/libvirt/images/<vm-name>/root.qcow2 +10G
+clonebox start . --user
+```
+
+Inside the VM:
+```bash
+sudo growpart /dev/vda 1
+sudo resize2fs /dev/vda1
+df -h /
+```
+
+### Known Issue: IBus Preferences crash
+
+During validation you may occasionally see a crash dialog from **IBus Preferences** in the Ubuntu desktop environment.
+This is an upstream issue related to the input method daemon (`ibus-daemon`) and obsolete system packages (e.g. `libglib2.0`, `libssl3`, `libxml2`, `openssl`).
+It does **not** affect CloneBox functionality and the VM operates normally.
+
+Workaround:
+- Dismiss the crash dialog
+- Or run `sudo apt upgrade` inside the VM to update system packages
+
+### Snap Apps Not Launching (PyCharm, Chromium, Firefox)
+
+If snap-installed applications (e.g., PyCharm, Chromium) are installed but don't launch when clicked, the issue is usually **disconnected snap interfaces**. This happens because snap interfaces are not auto-connected when installing via cloud-init.
+
+**New VMs created with updated CloneBox automatically connect snap interfaces**, but for older VMs or manual installs:
+
+```bash
+# Check snap interface connections
+snap connections pycharm-community
+
+# If you see "-" instead of ":desktop", interfaces are NOT connected
+
+# Connect required interfaces
+sudo snap connect pycharm-community:desktop :desktop
+sudo snap connect pycharm-community:desktop-legacy :desktop-legacy
+sudo snap connect pycharm-community:x11 :x11
+sudo snap connect pycharm-community:wayland :wayland
+sudo snap connect pycharm-community:home :home
+sudo snap connect pycharm-community:network :network
+
+# Restart snap daemon and try again
+sudo systemctl restart snapd
+snap run pycharm-community
+```
+
+**For Chromium/Firefox:**
+```bash
+sudo snap connect chromium:desktop :desktop
+sudo snap connect chromium:x11 :x11
+sudo snap connect firefox:desktop :desktop
+sudo snap connect firefox:x11 :x11
+```
+
+**Debug launch:**
+```bash
+PYCHARM_DEBUG=true snap run pycharm-community 2>&1 | tee /tmp/pycharm-debug.log
+```
+
+**Nuclear option (reinstall):**
+```bash
+snap remove pycharm-community
+rm -rf ~/snap/pycharm-community
+sudo snap install pycharm-community --classic
+sudo snap connect pycharm-community:desktop :desktop
+```
+
 ### Network Issues
 
 If you encounter "Network not found" or "network 'default' is not active" errors:
@@ -1069,4 +1258,4 @@ qm set 9000 --boot c --bootdisk scsi0
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file.
+Apache License - see [LICENSE](LICENSE) file.

{clonebox-0.1.20 → clonebox-0.1.21}/README.md

@@ -37,6 +37,22 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
 
+## Use Cases
+
+CloneBox excels in scenarios where developers need:
+- Isolated sandbox environments for testing AI agents, edge computing simulations, or integration workflows without risking host system stability
+- Reproducible development setups that can be quickly spun up with identical configurations across different machines
+- Safe experimentation with system-level changes that can be discarded by simply deleting the VM
+- Quick onboarding for new team members who need a fully configured development environment
+
+## 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
+
 
 
 
@@ -47,6 +63,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 container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
+- `clonebox dashboard` – lokalny dashboard (VM + containers)
 
 ### Dlaczego wirtualne klony workstation mają sens?
 
@@ -119,6 +137,11 @@ pip install -e .
 # Or directly
 pip install clonebox
 ```
+
+Dashboard ma opcjonalne zależności:
+```bash
+pip install "clonebox[dashboard]"
+```
 lub
 ```bash
 # Aktywuj venv
@@ -199,7 +222,34 @@ Simply run `clonebox` to start the interactive wizard:
 
 ```bash
 clonebox
-clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2
+
+clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2 --disk-size-gb 30
+
+clonebox test . --user --validate
+```
+
+### Profiles (Reusable presets)
+
+Profiles pozwalają trzymać gotowe presety dla VM/container (np. `ml-dev`, `web-dev`) i nakładać je na bazową konfigurację.
+
+```bash
+# Przykład: uruchom kontener z profilem
+clonebox container up . --profile ml-dev --engine podman
+
+# Przykład: generuj VM config z profilem
+clonebox clone . --profile ml-dev --user --run
+```
+
+Domyślne lokalizacje profili:
+- `~/.clonebox.d/<name>.yaml`
+- `./.clonebox.d/<name>.yaml`
+- wbudowane: `src/clonebox/templates/profiles/<name>.yaml`
+
+### Dashboard
+
+```bash
+clonebox dashboard --port 8080
+# http://127.0.0.1:8080
 ```
 
 The wizard will:
@@ -220,7 +270,10 @@ clonebox create --name my-dev-vm --config '{
   },
   "packages": ["python3", "nodejs", "docker.io"],
   "services": ["docker"]
-}' --ram 4096 --vcpus 4 --start
+}' --ram 4096 --vcpus 4 --disk-size-gb 20 --start
+
+# Create VM with larger root disk
+clonebox create --name my-dev-vm --disk-size-gb 30 --config '{"paths": {}, "packages": [], "services": []}'
 
 # List VMs
 clonebox list
@@ -277,10 +330,45 @@ clonebox clone . --user --run
 
 # Access in VM:
 ls ~/.config/google-chrome  # Chrome profile
-ls ~/.mozilla/firefox       # Firefox profile
-ls ~/.config/JetBrains      # PyCharm settings
+
+# Firefox profile (Ubuntu często używa snap):
+ls ~/snap/firefox/common/.mozilla/firefox
+ls ~/.mozilla/firefox
+
+# PyCharm profile (snap):
+ls ~/snap/pycharm-community/common/.config/JetBrains
+ls ~/.config/JetBrains
+```
+
+### Container workflow (podman/docker)
+
+```bash
+# Start a dev container (auto-detect engine if not specified)
+clonebox container up . --engine podman --detach
+
+# List running containers
+clonebox container ps
+
+# Stop/remove
+clonebox container stop <name>
+clonebox container rm <name>
+```
+
+### Full validation (VM)
+
+`clonebox test` weryfikuje, że VM faktycznie ma zamontowane ścieżki i spełnia wymagania z `.clonebox.yaml`.
+
+```bash
+clonebox test . --user --validate
 ```
 
+Walidowane kategorie:
+- **Mounts** (9p)
+- **Packages** (apt)
+- **Snap packages**
+- **Services** (enabled + running)
+- **Apps** (instalacja + dostępność profilu: Firefox/PyCharm/Chrome)
+
 ### Testing and Validating VM Configuration
 
 ```bash
@@ -509,6 +597,9 @@ The fastest way to clone your current working directory:
 # Base OS image is automatically downloaded to ~/Downloads on first run
 clonebox clone .
 
+# Increase VM disk size (recommended for GUI + large tooling)
+clonebox clone . --user --disk-size-gb 30
+
 # Clone specific path
 clonebox clone ~/projects/my-app
 
@@ -639,8 +730,10 @@ clonebox clone . --network auto
 | `clonebox clone . --replace` | Replace existing VM (stop, delete, recreate) |
 | `clonebox clone . --user` | Clone in user session (no root) |
 | `clonebox clone . --base-image <path>` | Use custom base image |
+| `clonebox clone . --disk-size-gb <gb>` | Set root disk size in GB (generated configs default to 20GB) |
 | `clonebox clone . --network user` | Use user-mode networking (slirp) |
 | `clonebox clone . --network auto` | Auto-detect network mode (default) |
+| `clonebox create --config <json> --disk-size-gb <gb>` | Create VM from JSON config with specified disk size |
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
@@ -653,6 +746,11 @@ clonebox clone . --network auto
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
+| `clonebox container up .` | Start a dev container for given path |
+| `clonebox container ps` | List containers |
+| `clonebox container stop <name>` | Stop a container |
+| `clonebox container rm <name>` | Remove a container |
+| `clonebox dashboard` | Run local dashboard (VM + containers) |
 | `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
 | `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration (basic checks) |
@@ -673,6 +771,97 @@ clonebox clone . --network auto
 
 ## Troubleshooting
 
+### Critical: Insufficient Disk Space
+
+If you install a full desktop environment and large development tools (e.g. `ubuntu-desktop-minimal`, `docker.io`, large snaps like `pycharm-community`/`chromium`), you may hit low disk space warnings inside the VM.
+
+Recommended fix:
+- Set a larger root disk in `.clonebox.yaml`:
+
+```yaml
+vm:
+  disk_size_gb: 30
+```
+
+You can also set it during config generation:
+```bash
+clonebox clone . --user --disk-size-gb 30
+```
+
+Notes:
+- New configs generated by `clonebox clone` default to `disk_size_gb: 20`.
+- You can override this by setting `vm.disk_size_gb` in `.clonebox.yaml`.
+
+Workaround for an existing VM (host-side resize + guest filesystem grow):
+```bash
+clonebox stop . --user
+qemu-img resize ~/.local/share/libvirt/images/<vm-name>/root.qcow2 +10G
+clonebox start . --user
+```
+
+Inside the VM:
+```bash
+sudo growpart /dev/vda 1
+sudo resize2fs /dev/vda1
+df -h /
+```
+
+### Known Issue: IBus Preferences crash
+
+During validation you may occasionally see a crash dialog from **IBus Preferences** in the Ubuntu desktop environment.
+This is an upstream issue related to the input method daemon (`ibus-daemon`) and obsolete system packages (e.g. `libglib2.0`, `libssl3`, `libxml2`, `openssl`).
+It does **not** affect CloneBox functionality and the VM operates normally.
+
+Workaround:
+- Dismiss the crash dialog
+- Or run `sudo apt upgrade` inside the VM to update system packages
+
+### Snap Apps Not Launching (PyCharm, Chromium, Firefox)
+
+If snap-installed applications (e.g., PyCharm, Chromium) are installed but don't launch when clicked, the issue is usually **disconnected snap interfaces**. This happens because snap interfaces are not auto-connected when installing via cloud-init.
+
+**New VMs created with updated CloneBox automatically connect snap interfaces**, but for older VMs or manual installs:
+
+```bash
+# Check snap interface connections
+snap connections pycharm-community
+
+# If you see "-" instead of ":desktop", interfaces are NOT connected
+
+# Connect required interfaces
+sudo snap connect pycharm-community:desktop :desktop
+sudo snap connect pycharm-community:desktop-legacy :desktop-legacy
+sudo snap connect pycharm-community:x11 :x11
+sudo snap connect pycharm-community:wayland :wayland
+sudo snap connect pycharm-community:home :home
+sudo snap connect pycharm-community:network :network
+
+# Restart snap daemon and try again
+sudo systemctl restart snapd
+snap run pycharm-community
+```
+
+**For Chromium/Firefox:**
+```bash
+sudo snap connect chromium:desktop :desktop
+sudo snap connect chromium:x11 :x11
+sudo snap connect firefox:desktop :desktop
+sudo snap connect firefox:x11 :x11
+```
+
+**Debug launch:**
+```bash
+PYCHARM_DEBUG=true snap run pycharm-community 2>&1 | tee /tmp/pycharm-debug.log
+```
+
+**Nuclear option (reinstall):**
+```bash
+snap remove pycharm-community
+rm -rf ~/snap/pycharm-community
+sudo snap install pycharm-community --classic
+sudo snap connect pycharm-community:desktop :desktop
+```
+
 ### Network Issues
 
 If you encounter "Network not found" or "network 'default' is not active" errors:
@@ -1021,4 +1210,4 @@ qm set 9000 --boot c --bootdisk scsi0
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file.
+Apache License - see [LICENSE](LICENSE) file.

{clonebox-0.1.20 → clonebox-0.1.21}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "clonebox"
-version = "0.1.20"
+version = "0.1.21"
 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.20 → clonebox-0.1.21}/src/clonebox/cli.py

@@ -653,6 +653,7 @@ def interactive_mode():
     summary_table.add_row("Name", vm_name)
     summary_table.add_row("RAM", f"{ram_mb} MB")
     summary_table.add_row("vCPUs", str(vcpus))
+    summary_table.add_row("Disk", f"{20 if enable_gui else 10} GB")
     summary_table.add_row("Services", ", ".join(selected_services) or "None")
     summary_table.add_row(
         "Packages",
@@ -684,6 +685,7 @@ def interactive_mode():
         name=vm_name,
         ram_mb=ram_mb,
         vcpus=vcpus,
+        disk_size_gb=20 if enable_gui else 10,
         gui=enable_gui,
         base_image=base_image if base_image else None,
         paths=paths_mapping,
@@ -732,6 +734,7 @@ def cmd_create(args):
         name=args.name,
         ram_mb=args.ram,
         vcpus=args.vcpus,
+        disk_size_gb=getattr(args, "disk_size_gb", 10),
         gui=not args.no_gui,
         base_image=args.base_image,
         paths=config_data.get("paths", {}),
@@ -1708,6 +1711,7 @@ def generate_clonebox_yaml(
     vm_name: str = None,
     network_mode: str = "auto",
     base_image: Optional[str] = None,
+    disk_size_gb: Optional[int] = None,
 ) -> str:
     """Generate YAML config from system snapshot."""
     sys_info = detector.get_system_info()
@@ -1813,6 +1817,9 @@ def generate_clonebox_yaml(
     ram_mb = min(4096, int(sys_info["memory_available_gb"] * 1024 * 0.5))
     vcpus = max(2, sys_info["cpu_count"] // 2)
 
+    if disk_size_gb is None:
+        disk_size_gb = 20
+
     # Auto-detect packages from running applications and services
     app_packages = detector.suggest_packages_for_apps(snapshot.applications)
     service_packages = detector.suggest_packages_for_services(snapshot.running_services)
@@ -1871,6 +1878,7 @@ def generate_clonebox_yaml(
             "name": vm_name,
             "ram_mb": ram_mb,
             "vcpus": vcpus,
+            "disk_size_gb": disk_size_gb,
             "gui": True,
             "base_image": base_image,
             "network_mode": network_mode,
@@ -2024,6 +2032,7 @@ def create_vm_from_config(
         name=config["vm"]["name"],
         ram_mb=config["vm"].get("ram_mb", 4096),
         vcpus=config["vm"].get("vcpus", 4),
+        disk_size_gb=config["vm"].get("disk_size_gb", 10),
         gui=config["vm"].get("gui", True),
         base_image=config["vm"].get("base_image"),
         paths=all_paths,
@@ -2103,6 +2112,7 @@ def cmd_clone(args):
         vm_name=vm_name,
         network_mode=args.network,
         base_image=getattr(args, "base_image", None),
+        disk_size_gb=getattr(args, "disk_size_gb", None),
     )
 
     profile_name = getattr(args, "profile", None)
@@ -2345,6 +2355,12 @@ def main():
     )
     create_parser.add_argument("--ram", type=int, default=4096, help="RAM in MB")
     create_parser.add_argument("--vcpus", type=int, default=4, help="Number of vCPUs")
+    create_parser.add_argument(
+        "--disk-size-gb",
+        type=int,
+        default=10,
+        help="Root disk size in GB (default: 10)",
+    )
     create_parser.add_argument("--base-image", help="Path to base qcow2 image")
     create_parser.add_argument("--no-gui", action="store_true", help="Disable SPICE graphics")
     create_parser.add_argument("--start", "-s", action="store_true", help="Start VM after creation")
@@ -2551,6 +2567,12 @@ def main():
         "--base-image",
         help="Path to a bootable qcow2 image to use as a base disk",
     )
+    clone_parser.add_argument(
+        "--disk-size-gb",
+        type=int,
+        default=None,
+        help="Root disk size in GB (default: 20 for generated configs)",
+    )
     clone_parser.add_argument(
         "--profile",
         help="Profile name (loads ~/.clonebox.d/<name>.yaml, .clonebox.d/<name>.yaml, or built-in templates)",

{clonebox-0.1.20 → clonebox-0.1.21}/src/clonebox/cloner.py

@@ -18,6 +18,16 @@ try:
 except ImportError:
     libvirt = None
 
+SNAP_INTERFACES = {
+    'pycharm-community': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'network-bind', 'cups-control', 'removable-media'],
+    'chromium': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback', 'camera'],
+    'firefox': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback', 'removable-media'],
+    'code': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'ssh-keys'],
+    'slack': ['desktop', 'desktop-legacy', 'x11', 'wayland', 'home', 'network', 'audio-playback'],
+    'spotify': ['desktop', 'x11', 'wayland', 'home', 'network', 'audio-playback'],
+}
+DEFAULT_SNAP_INTERFACES = ['desktop', 'desktop-legacy', 'x11', 'home', 'network']
+
 
 @dataclass
 class VMConfig:
@@ -26,7 +36,7 @@ class VMConfig:
     name: str = "clonebox-vm"
     ram_mb: int = 4096
     vcpus: int = 4
-    disk_size_gb: int = 10
+    disk_size_gb: int = 20
     gui: bool = True
     base_image: Optional[str] = None
     paths: dict = field(default_factory=dict)
@@ -680,7 +690,7 @@ fi
 
         # User-data
         # Add desktop environment if GUI is enabled
-        base_packages = ["qemu-guest-agent"]
+        base_packages = ["qemu-guest-agent", "cloud-guest-utils"]
         if config.gui:
             base_packages.extend([
                 "ubuntu-desktop-minimal",
@@ -719,6 +729,15 @@ fi
             runcmd_lines.append("  - echo 'Installing snap packages...'")
             for snap_pkg in config.snap_packages:
                 runcmd_lines.append(f"  - snap install {snap_pkg} --classic || snap install {snap_pkg} || true")
+            
+            # Connect snap interfaces for GUI apps (not auto-connected via cloud-init)
+            runcmd_lines.append("  - echo 'Connecting snap interfaces...'")
+            for snap_pkg in config.snap_packages:
+                interfaces = SNAP_INTERFACES.get(snap_pkg, DEFAULT_SNAP_INTERFACES)
+                for iface in interfaces:
+                    runcmd_lines.append(f"  - snap connect {snap_pkg}:{iface} :{iface} 2>/dev/null || true")
+
+            runcmd_lines.append("  - systemctl restart snapd || true")
         
         # Add GUI setup if enabled - runs AFTER package installation completes
         if config.gui:
@@ -770,6 +789,13 @@ ssh_pwauth: true
 chpasswd:
   expire: false
 
+# Make sure root partition + filesystem grows to fill the qcow2 disk size
+growpart:
+  mode: auto
+  devices: ["/"]
+  ignore_growroot_disabled: false
+resize_rootfs: true
+
 # Update package cache and upgrade
 package_update: true
 package_upgrade: false

{clonebox-0.1.20 → clonebox-0.1.21}/src/clonebox/models.py

@@ -16,7 +16,7 @@ class VMSettings(BaseModel):
     name: str = Field(default="clonebox-vm", description="VM name")
     ram_mb: int = Field(default=4096, ge=512, le=131072, description="RAM in MB")
     vcpus: int = Field(default=4, ge=1, le=128, description="Number of vCPUs")
-    disk_size_gb: int = Field(default=10, ge=1, le=2048, description="Disk size in GB")
+    disk_size_gb: int = Field(default=20, ge=1, le=2048, description="Disk size in GB")
     gui: bool = Field(default=True, description="Enable SPICE graphics")
     base_image: Optional[str] = Field(default=None, description="Path to base qcow2 image")
     network_mode: str = Field(default="auto", description="Network mode: auto|default|user")
@@ -107,6 +107,10 @@ class CloneBoxConfig(BaseModel):
         """Convert to legacy VMConfig dataclass for compatibility."""
         from clonebox.cloner import VMConfig as VMConfigDataclass
 
+        # Merge paths and app_data_paths
+        all_paths = dict(self.paths)
+        all_paths.update(self.app_data_paths)
+
         return VMConfigDataclass(
             name=self.vm.name,
             ram_mb=self.vm.ram_mb,
@@ -114,7 +118,7 @@ class CloneBoxConfig(BaseModel):
             disk_size_gb=self.vm.disk_size_gb,
             gui=self.vm.gui,
             base_image=self.vm.base_image,
-            paths=self.paths,
+            paths=all_paths,
             packages=self.packages,
             snap_packages=self.snap_packages,
             services=self.services,

{clonebox-0.1.20 → clonebox-0.1.21/src/clonebox.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clonebox
-Version: 0.1.20
+Version: 0.1.21
 Summary: Clone your workstation environment to an isolated VM with selective apps, paths and services
 Author: CloneBox Team
 License: Apache-2.0
@@ -85,6 +85,22 @@ CloneBox lets you create isolated virtual machines with only the applications, d
 - 🧪 **Configuration testing** - Validate VM settings and functionality
 - 📁 **App data sync** - Include browser profiles, IDE settings, and app configs
 
+## Use Cases
+
+CloneBox excels in scenarios where developers need:
+- Isolated sandbox environments for testing AI agents, edge computing simulations, or integration workflows without risking host system stability
+- Reproducible development setups that can be quickly spun up with identical configurations across different machines
+- Safe experimentation with system-level changes that can be discarded by simply deleting the VM
+- Quick onboarding for new team members who need a fully configured development environment
+
+## 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
+
 
 
 
@@ -95,6 +111,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 container up|ps|stop|rm` – lekki runtime kontenerowy (podman/docker)
+- `clonebox dashboard` – lokalny dashboard (VM + containers)
 
 ### Dlaczego wirtualne klony workstation mają sens?
 
@@ -167,6 +185,11 @@ pip install -e .
 # Or directly
 pip install clonebox
 ```
+
+Dashboard ma opcjonalne zależności:
+```bash
+pip install "clonebox[dashboard]"
+```
 lub
 ```bash
 # Aktywuj venv
@@ -247,7 +270,34 @@ Simply run `clonebox` to start the interactive wizard:
 
 ```bash
 clonebox
-clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2
+
+clonebox clone . --user --run --replace --base-image ~/ubuntu-22.04-cloud.qcow2 --disk-size-gb 30
+
+clonebox test . --user --validate
+```
+
+### Profiles (Reusable presets)
+
+Profiles pozwalają trzymać gotowe presety dla VM/container (np. `ml-dev`, `web-dev`) i nakładać je na bazową konfigurację.
+
+```bash
+# Przykład: uruchom kontener z profilem
+clonebox container up . --profile ml-dev --engine podman
+
+# Przykład: generuj VM config z profilem
+clonebox clone . --profile ml-dev --user --run
+```
+
+Domyślne lokalizacje profili:
+- `~/.clonebox.d/<name>.yaml`
+- `./.clonebox.d/<name>.yaml`
+- wbudowane: `src/clonebox/templates/profiles/<name>.yaml`
+
+### Dashboard
+
+```bash
+clonebox dashboard --port 8080
+# http://127.0.0.1:8080
 ```
 
 The wizard will:
@@ -268,7 +318,10 @@ clonebox create --name my-dev-vm --config '{
   },
   "packages": ["python3", "nodejs", "docker.io"],
   "services": ["docker"]
-}' --ram 4096 --vcpus 4 --start
+}' --ram 4096 --vcpus 4 --disk-size-gb 20 --start
+
+# Create VM with larger root disk
+clonebox create --name my-dev-vm --disk-size-gb 30 --config '{"paths": {}, "packages": [], "services": []}'
 
 # List VMs
 clonebox list
@@ -325,10 +378,45 @@ clonebox clone . --user --run
 
 # Access in VM:
 ls ~/.config/google-chrome  # Chrome profile
-ls ~/.mozilla/firefox       # Firefox profile
-ls ~/.config/JetBrains      # PyCharm settings
+
+# Firefox profile (Ubuntu często używa snap):
+ls ~/snap/firefox/common/.mozilla/firefox
+ls ~/.mozilla/firefox
+
+# PyCharm profile (snap):
+ls ~/snap/pycharm-community/common/.config/JetBrains
+ls ~/.config/JetBrains
+```
+
+### Container workflow (podman/docker)
+
+```bash
+# Start a dev container (auto-detect engine if not specified)
+clonebox container up . --engine podman --detach
+
+# List running containers
+clonebox container ps
+
+# Stop/remove
+clonebox container stop <name>
+clonebox container rm <name>
+```
+
+### Full validation (VM)
+
+`clonebox test` weryfikuje, że VM faktycznie ma zamontowane ścieżki i spełnia wymagania z `.clonebox.yaml`.
+
+```bash
+clonebox test . --user --validate
 ```
 
+Walidowane kategorie:
+- **Mounts** (9p)
+- **Packages** (apt)
+- **Snap packages**
+- **Services** (enabled + running)
+- **Apps** (instalacja + dostępność profilu: Firefox/PyCharm/Chrome)
+
 ### Testing and Validating VM Configuration
 
 ```bash
@@ -557,6 +645,9 @@ The fastest way to clone your current working directory:
 # Base OS image is automatically downloaded to ~/Downloads on first run
 clonebox clone .
 
+# Increase VM disk size (recommended for GUI + large tooling)
+clonebox clone . --user --disk-size-gb 30
+
 # Clone specific path
 clonebox clone ~/projects/my-app
 
@@ -687,8 +778,10 @@ clonebox clone . --network auto
 | `clonebox clone . --replace` | Replace existing VM (stop, delete, recreate) |
 | `clonebox clone . --user` | Clone in user session (no root) |
 | `clonebox clone . --base-image <path>` | Use custom base image |
+| `clonebox clone . --disk-size-gb <gb>` | Set root disk size in GB (generated configs default to 20GB) |
 | `clonebox clone . --network user` | Use user-mode networking (slirp) |
 | `clonebox clone . --network auto` | Auto-detect network mode (default) |
+| `clonebox create --config <json> --disk-size-gb <gb>` | Create VM from JSON config with specified disk size |
 | `clonebox start .` | Start VM from `.clonebox.yaml` in current dir |
 | `clonebox start . --viewer` | Start VM and open GUI window |
 | `clonebox start <name>` | Start existing VM by name |
@@ -701,6 +794,11 @@ clonebox clone . --network auto
 | `clonebox detect --yaml` | Output as YAML config |
 | `clonebox detect --yaml --dedupe` | YAML with duplicates removed |
 | `clonebox detect --json` | Output as JSON |
+| `clonebox container up .` | Start a dev container for given path |
+| `clonebox container ps` | List containers |
+| `clonebox container stop <name>` | Stop a container |
+| `clonebox container rm <name>` | Remove a container |
+| `clonebox dashboard` | Run local dashboard (VM + containers) |
 | `clonebox status . --user` | Check VM health, cloud-init, IP, and mount status |
 | `clonebox status . --user --health` | Check VM status and run full health check |
 | `clonebox test . --user` | Test VM configuration (basic checks) |
@@ -721,6 +819,97 @@ clonebox clone . --network auto
 
 ## Troubleshooting
 
+### Critical: Insufficient Disk Space
+
+If you install a full desktop environment and large development tools (e.g. `ubuntu-desktop-minimal`, `docker.io`, large snaps like `pycharm-community`/`chromium`), you may hit low disk space warnings inside the VM.
+
+Recommended fix:
+- Set a larger root disk in `.clonebox.yaml`:
+
+```yaml
+vm:
+  disk_size_gb: 30
+```
+
+You can also set it during config generation:
+```bash
+clonebox clone . --user --disk-size-gb 30
+```
+
+Notes:
+- New configs generated by `clonebox clone` default to `disk_size_gb: 20`.
+- You can override this by setting `vm.disk_size_gb` in `.clonebox.yaml`.
+
+Workaround for an existing VM (host-side resize + guest filesystem grow):
+```bash
+clonebox stop . --user
+qemu-img resize ~/.local/share/libvirt/images/<vm-name>/root.qcow2 +10G
+clonebox start . --user
+```
+
+Inside the VM:
+```bash
+sudo growpart /dev/vda 1
+sudo resize2fs /dev/vda1
+df -h /
+```
+
+### Known Issue: IBus Preferences crash
+
+During validation you may occasionally see a crash dialog from **IBus Preferences** in the Ubuntu desktop environment.
+This is an upstream issue related to the input method daemon (`ibus-daemon`) and obsolete system packages (e.g. `libglib2.0`, `libssl3`, `libxml2`, `openssl`).
+It does **not** affect CloneBox functionality and the VM operates normally.
+
+Workaround:
+- Dismiss the crash dialog
+- Or run `sudo apt upgrade` inside the VM to update system packages
+
+### Snap Apps Not Launching (PyCharm, Chromium, Firefox)
+
+If snap-installed applications (e.g., PyCharm, Chromium) are installed but don't launch when clicked, the issue is usually **disconnected snap interfaces**. This happens because snap interfaces are not auto-connected when installing via cloud-init.
+
+**New VMs created with updated CloneBox automatically connect snap interfaces**, but for older VMs or manual installs:
+
+```bash
+# Check snap interface connections
+snap connections pycharm-community
+
+# If you see "-" instead of ":desktop", interfaces are NOT connected
+
+# Connect required interfaces
+sudo snap connect pycharm-community:desktop :desktop
+sudo snap connect pycharm-community:desktop-legacy :desktop-legacy
+sudo snap connect pycharm-community:x11 :x11
+sudo snap connect pycharm-community:wayland :wayland
+sudo snap connect pycharm-community:home :home
+sudo snap connect pycharm-community:network :network
+
+# Restart snap daemon and try again
+sudo systemctl restart snapd
+snap run pycharm-community
+```
+
+**For Chromium/Firefox:**
+```bash
+sudo snap connect chromium:desktop :desktop
+sudo snap connect chromium:x11 :x11
+sudo snap connect firefox:desktop :desktop
+sudo snap connect firefox:x11 :x11
+```
+
+**Debug launch:**
+```bash
+PYCHARM_DEBUG=true snap run pycharm-community 2>&1 | tee /tmp/pycharm-debug.log
+```
+
+**Nuclear option (reinstall):**
+```bash
+snap remove pycharm-community
+rm -rf ~/snap/pycharm-community
+sudo snap install pycharm-community --classic
+sudo snap connect pycharm-community:desktop :desktop
+```
+
 ### Network Issues
 
 If you encounter "Network not found" or "network 'default' is not active" errors:
@@ -1069,4 +1258,4 @@ qm set 9000 --boot c --bootdisk scsi0
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file.
+Apache License - see [LICENSE](LICENSE) file.

{clonebox-0.1.20 → clonebox-0.1.21}/tests/test_cli.py

@@ -170,6 +170,24 @@ class TestGenerateCloneboxYaml:
 
         assert config["vm"]["base_image"] == "/images/base.qcow2"
 
+    def test_generate_yaml_includes_disk_size_default(self):
+        snapshot = self.create_mock_snapshot()
+        detector = self.create_mock_detector()
+
+        yaml_str = generate_clonebox_yaml(snapshot, detector)
+        config = yaml.safe_load(yaml_str)
+
+        assert config["vm"]["disk_size_gb"] == 20
+
+    def test_generate_yaml_disk_size_override(self):
+        snapshot = self.create_mock_snapshot()
+        detector = self.create_mock_detector()
+
+        yaml_str = generate_clonebox_yaml(snapshot, detector, disk_size_gb=42)
+        config = yaml.safe_load(yaml_str)
+
+        assert config["vm"]["disk_size_gb"] == 42
+
 
 class TestLoadCloneboxConfig:
     """Test loading .clonebox.yaml configs."""
@@ -334,6 +352,7 @@ class TestCLIIntegration:
             user=True,
             network="auto",
             base_image=None,
+            disk_size_gb=None,
             replace=False,
         )
         cmd_clone(args)
@@ -343,6 +362,35 @@ class TestCLIIntegration:
         assert "vm" in config
         assert "version" in config
 
+    @patch("clonebox.cli.SelectiveVMCloner")
+    def test_create_vm_from_config_propagates_disk_size(self, mock_cloner_class, tmp_path):
+        from clonebox.cli import create_vm_from_config
+
+        mock_cloner = MagicMock()
+        mock_cloner.create_vm.return_value = "uuid-123"
+        mock_cloner.check_prerequisites.return_value = {
+            "images_dir_writable": True,
+            "images_dir": "/tmp",
+            "session_type": "user",
+        }
+        mock_cloner_class.return_value = mock_cloner
+
+        cfg = {
+            "version": "1",
+            "vm": {"name": "test-vm", "disk_size_gb": 50},
+            "paths": {},
+            "packages": [],
+            "snap_packages": [],
+            "services": [],
+            "post_commands": [],
+        }
+
+        create_vm_from_config(cfg, start=False, user_session=True, replace=False)
+
+        assert mock_cloner.create_vm.called
+        passed_vm_config = mock_cloner.create_vm.call_args[0][0]
+        assert getattr(passed_vm_config, "disk_size_gb") == 50
+
 
 class TestCLIParametrized:
     """Parametrized CLI tests."""

{clonebox-0.1.20 → clonebox-0.1.21}/tests/test_cloner.py

@@ -17,7 +17,7 @@ class TestVMConfig:
         assert config.name == "clonebox-vm"
         assert config.ram_mb == 4096
         assert config.vcpus == 4
-        assert config.disk_size_gb == 10
+        assert config.disk_size_gb == 20
         assert config.gui is True
         assert config.base_image is None
         assert config.paths == {}

clonebox-0.1.21/tests/test_profiles.py

@@ -0,0 +1,56 @@
+from pathlib import Path
+
+import pytest
+
+from clonebox.profiles import load_profile, merge_with_profile
+
+
+def test_profile_loader_finds_default_profiles(tmp_path: Path):
+    (tmp_path / "templates" / "profiles").mkdir(parents=True)
+    (tmp_path / "templates" / "profiles" / "ml-dev.yaml").write_text(
+        """
+container:
+  image: python:3.11-slim
+""".lstrip()
+    )
+
+    profile = load_profile("ml-dev", [tmp_path])
+    assert profile["container"]["image"] == "python:3.11-slim"
+
+
+def test_profile_merges_over_base():
+    base = {"container": {"image": "ubuntu:22.04"}}
+    prof = {"container": {"image": "python:3.11-slim"}}
+
+    merged = merge_with_profile(base, profile=prof)
+    assert merged["container"]["image"] == "python:3.11-slim"
+
+
+def test_profile_deep_merge_nested_dicts():
+    base = {"container": {"env": {"A": "1", "B": "2"}, "image": "ubuntu:22.04"}}
+    prof = {"container": {"env": {"B": "override", "C": "3"}}}
+
+    merged = merge_with_profile(base, profile=prof)
+    assert merged["container"]["image"] == "ubuntu:22.04"
+    assert merged["container"]["env"] == {"A": "1", "B": "override", "C": "3"}
+
+
+def test_merge_with_profile_invalid_profile_is_noop():
+    base = {"container": {"image": "ubuntu:22.04"}}
+    merged = merge_with_profile(base, profile=123)  # type: ignore[arg-type]
+    assert merged == base
+
+
+def test_load_profile_prefers_search_paths_over_builtins(tmp_path: Path):
+    # Put profile in a search path
+    (tmp_path / "templates" / "profiles").mkdir(parents=True)
+    (tmp_path / "templates" / "profiles" / "ml-dev.yaml").write_text(
+        """
+container:
+  image: python:3.11-slim
+""".lstrip()
+    )
+
+    profile = load_profile("ml-dev", [tmp_path])
+    assert profile is not None
+    assert profile["container"]["image"] == "python:3.11-slim"

{clonebox-0.1.20 → clonebox-0.1.21}/tests/test_validator.py

@@ -168,6 +168,56 @@ class TestVMValidatorApps:
         assert results["total"] == 2
         assert results["failed"] == 1
 
+
+class TestVMValidatorServices:
+    @pytest.fixture
+    def sample_config(self):
+        return {
+            "vm": {"name": "test-vm"},
+            "paths": {
+                "/home/user/projects": "/mnt/projects",
+                "/home/user/data": "/mnt/data",
+            },
+            "app_data_paths": {
+                "/home/user/.config/test": "/home/ubuntu/.config/test",
+            },
+            "packages": ["curl", "git", "vim"],
+            "snap_packages": ["code"],
+            "services": ["docker", "ssh"],
+        }
+
+    @pytest.fixture
+    def mock_console(self):
+        console = MagicMock()
+        console.print = MagicMock()
+        return console
+
+    def test_validate_services_skips_host_only(self, mock_console):
+        config = {
+            "vm": {"name": "test-vm"},
+            "paths": {},
+            "app_data_paths": {},
+            "packages": [],
+            "snap_packages": [],
+            "services": ["libvirtd", "docker"],
+        }
+
+        validator = VMValidator(config=config, vm_name="test-vm", conn_uri="qemu:///session", console=mock_console)
+
+        def fake_exec(cmd: str, timeout: int = 10):
+            if "systemctl is-enabled docker" in cmd:
+                return "enabled"
+            if "systemctl is-active docker" in cmd:
+                return "active"
+            return ""
+
+        validator._exec_in_vm = fake_exec
+
+        results = validator.validate_services()
+        assert results["total"] == 1
+        assert results["passed"] == 1
+        assert results.get("skipped") == 1
+
     @patch('subprocess.run')
     def test_exec_in_vm_success(self, mock_run, sample_config, mock_console):
         """Test successful command execution in VM."""

clonebox-0.1.20/tests/test_profiles.py

@@ -1,26 +0,0 @@
-from pathlib import Path
-
-import pytest
-
-from clonebox.profiles import load_profile, merge_with_profile
-
-
-def test_profile_loader_finds_default_profiles(tmp_path: Path):
-    (tmp_path / "templates" / "profiles").mkdir(parents=True)
-    (tmp_path / "templates" / "profiles" / "ml-dev.yaml").write_text(
-        """
-container:
-  image: python:3.11-slim
-""".lstrip()
-    )
-
-    profile = load_profile("ml-dev", [tmp_path])
-    assert profile["container"]["image"] == "python:3.11-slim"
-
-
-def test_profile_merges_over_base():
-    base = {"container": {"image": "ubuntu:22.04"}}
-    prof = {"container": {"image": "python:3.11-slim"}}
-
-    merged = merge_with_profile(base, profile=prof)
-    assert merged["container"]["image"] == "python:3.11-slim"