菜单
Mounts a virtiofs share tagged `workspace` at /workspace inside a VM guest via a systemd .mount unit. Use when a kind:vm entity shares a host directory into the guest and you need it auto-mounted (and re-mounted at every boot).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
MUST be invoked before any work involving: the `charly migrate` command (the single idempotent migration that brings any opencharly config up to the latest schema CalVer), the CalVer schema-version stamp (`version: YYYY.DDD.HHMM`), the CUE-anchored HEAD/floor (`charly/schema/version.cue` → `#SchemaVersion`/`#SchemaFloor`), the declarative migration table (`charly/migrations.cue`, applied by the core op-walker in `charly/migrate_engine.go`), the `LatestSchemaVersion()` load-time gate, or adding a new schema cutover as a migration-table entry.
MUST be invoked before any work involving: charly secrets commands, Secret Service / config-file credential management, GPG-encrypted .secrets files, credential import/export, or secret administration.
Authoritative reference for the "Hard Cutover by Default" policy governing schema changes, API renames, and deprecations. Forbidden patterns, required deliverables, rationale, examples from this repo, and the no-exception enforcement: plans are authored as full-scope single-phase cutovers and executed end-to-end regardless of estimated time, context, or scope. MUST be invoked when planning or reviewing any breaking change to Go types, YAML field names, CLI flags, or OCI labels.
Use when committing, branching, pushing, merging, tagging, creating PRs, or approving/merging PRs with gh — the feat/-branch, R10-gated, never-force-push landing workflow across the main repo + the plugins submodule + box/<distro> submodules. Covers sync-to-upstream, branch/worktree pruning, the fork+PR path for contributors without write access, and cross-repo @github landing order.
Go CLI development: building the charly binary, running tests, understanding the source code structure. MUST be invoked before reading or modifying any Go source file in charly/.
the `libvirt:` libvirt-RPC check verb for VMs — domain info, framebuffer screenshots, send-key, passwd, QMP, qemu-guest-agent client, snapshots, events — served out-of-process by candy/plugin-vm.
| name | workspace-mount |
| description | Mounts a virtiofs share tagged `workspace` at /workspace inside a VM guest via a systemd .mount unit. Use when a kind:vm entity shares a host directory into the guest and you need it auto-mounted (and re-mounted at every boot). |
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.
mkdir /workspace/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 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.
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 check gate's skip-with-explanation pattern.The cachyos-coder operator workstation VM (box/cachyos), mounting the
operator's /home/<user> → /workspace. Generic for any pod-in-VM share.
/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 referenceUse when authoring or debugging a virtiofs host-directory share mounted into a VM
guest, or the workspace-mount candy specifically.