overthinkos/workspace-mount

workspace-mount — virtiofs /workspace mount

A guest-side candy that mounts the virtiofs share tagged workspace at /workspace and enables it so it re-mounts on every boot — load-bearing for an autostarting VM that must come back with its share already mounted.

What it does

• mkdir /workspace
• writes /etc/systemd/system/workspace.mount (What=workspace, Where=/workspace, Type=virtiofs, WantedBy=multi-user.target)
• systemctl daemon-reload + enable (boot) + start (now, tolerant) — the start is || true so an image-build chroot with no device / no systemd does not fail the candy; the enabled unit mounts at the next boot.

The contract

The mount tag workspace is the contract between the host-side share and this candy. The kind: vm entity must declare a matching virtiofs filesystem:

libvirt:
  devices:
    filesystems:
      - {driver: virtiofs, accessmode: passthrough, source: /home/me, target: workspace}

target: workspace (the entity) ↔ What=workspace (this candy). The shared memory backing virtiofs requires is auto-paired by the renderer (see /charly-internals:libvirt-renderer), so the entity declares only the filesystem.

Eval

• workspace-mount-unit — the .mount unit file contains Type=virtiofs.
• workspace-virtiofs-rw — skip-aware: N/A when no share is attached (image build / no-device target); when /workspace IS mounted it MUST be virtiofs and writable. Mirrors the GPU eval gate's skip-with-explanation pattern.

Used in

The cachyos-coder operator workstation VM (box/cachyos), mounting the operator's /home/atrawog → /workspace. Generic for any pod-in-VM share.

Related

• /charly-internals:libvirt-renderer — mapFilesystem + ensureVirtiofsSharedMemory
• /charly-vm:vms-catalog — filesystems: authoring on the kind:vm entity
• /charly-vm:cachyos — the CachyOS VM family that consumes it
• /charly-image:layer — candy authoring reference

When to Use This Skill

Use when authoring or debugging a virtiofs host-directory share mounted into a VM guest, or the workspace-mount candy specifically.