Agent Plugins Marketplace
← All plugins

charly-vm

Schema authoring reference for `kind: vm` + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.

CodexClaude Code7 Skills

By opencharlyLicense: MIT0 GitHub starsUpdated last week

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
7 skill or MCP entries
Source updated
Oct 1, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install charly-vm for Codex and Claude Code

Installs for the current user
codex plugin marketplace add opencharly/marketplace
codex plugin marketplace upgrade charly-plugins
codex plugin add charly-vm@charly-plugins

Paste and run these commands in a terminal with Codex. They add and refresh the charly-plugins catalog, then install this plugin.

Compatibility: the page URL and API slug “charly-vm” remain stable.

  • Codex: charly-vm@agent-plugin-marketplace → charly-vm@charly-plugins

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/opencharly/marketplace

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is vm/.

Plugin files

vm/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/arch-cloud-vm/SKILL.md
├── skills/cachyos-bootstrap-vm/SKILL.md
├── skills/debian-debootstrap-vm/SKILL.md
├── skills/omarchy-vm/SKILL.md
├── skills/ubuntu-debootstrap-vm/SKILL.md
├── skills/vm/SKILL.md
└── skills/vms-catalog/SKILL.md

Included Skills7

arch-cloud-vmskills/arch-cloud-vm/SKILL.md

First kind:vm entity with source.kind: cloud_image — fetches the Arch Linux cloud qcow2 from pkgbuild.com, applies cloud-init, boots under libvirt/QEMU via BIOS firmware + virtio-gpu. Documents the stale-BOOTX64.EFI RCA, the simpledrm-to-qxldrmfb takeover race, the adopt-user pattern, and resource sizing. MUST be invoked before editing arch in box/arch/charly.yml or authoring another cloud_image VM from a template.

cachyos-bootstrap-vmskills/cachyos-bootstrap-vm/SKILL.md

CachyOS bootstrap VM (kind:vm cachyos-vm) — source.kind: bootstrap via cachyos-pacstrap-builder + pacstrap, btrfs rootfs, uefi-insecure. Plus the disposable check-cachyos-vm deploy. Lives in the opencharly/distro-cachyos submodule. Use before editing cachyos-vm or its check bed.

debian-debootstrap-vmskills/debian-debootstrap-vm/SKILL.md

Debian bootstrap VM (kind:vm debian-debootstrap) — source.kind: bootstrap via debian-debootstrap-builder + debootstrap, ext4 rootfs, uefi-insecure. Plus the disposable check-debian-debootstrap-vm deploy. Lives in the opencharly/distro-debian submodule. Use before editing debian-debootstrap or its check bed.

omarchy-vmskills/omarchy-vm/SKILL.md

The Omarchy VMs — `omarchy-vm` (source.kind: iso, the official installer run fully unattended), `omarchy-pacstrap-vm` (charly's own from-packages path), and the `charly-omarchy` keeper. Covers the seed answer files, the disk-first boot order, and which bed proves what. Use before editing omarchy-vm.

ubuntu-debootstrap-vmskills/ubuntu-debootstrap-vm/SKILL.md

Ubuntu bootstrap VM (kind:vm ubuntu-debootstrap) — source.kind: bootstrap via ubuntu-debootstrap-builder + debootstrap, ext4 rootfs, uefi-insecure. Plus the disposable check-ubuntu-debootstrap-vm deploy. Lives in the opencharly/distro-ubuntu submodule. Use before editing ubuntu-debootstrap or its check bed.

vmskills/vm/SKILL.md

MUST be invoked before any work involving: virtual machines, `charly vm` commands, kind:vm entities in charly.yml, cloud_image vs bootc source types, libvirt/QEMU backends, BIOS vs UEFI firmware, virtio-gpu video, or VM lifecycle.

vms-catalogskills/vms-catalog/SKILL.md

Authoring reference for kind:vm entities in vm.yml — the VmSpec schema, source.kind discriminator (cloud_image vs bootc), base_user adopt pattern, and step-by-step recipes for both source kinds. Use before authoring or editing vm.yml entries.

Plugin manifests2

vm/.codex-plugin/plugin.json
{
  "name": "charly-vm",
  "description": "Schema authoring reference for `kind: vm` + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.",
  "author": {
    "name": "opencharly"
  },
  "repository": "https://github.com/opencharly/marketplace",
  "skills": "./skills/",
  "interface": {
    "displayName": "OpenCharly Vm",
    "shortDescription": "Schema authoring reference for `kind: vm` + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.",
    "longDescription": "Schema authoring reference for `kind: vm` + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.",
    "developerName": "opencharly",
    "category": "kind",
    "capabilities": [
      "Instructions"
    ],
    "defaultPrompt": [
      "Use OpenCharly Vm for this OpenCharly task."
    ]
  }
}
vm/.claude-plugin/plugin.json
{
  "name": "charly-vm",
  "description": "Schema authoring reference for `kind: vm` + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.",
  "author": {
    "name": "opencharly"
  },
  "homepage": "https://github.com/opencharly/charly",
  "repository": "https://github.com/opencharly/marketplace",
  "license": "MIT",
  "keywords": [
    "charly",
    "vm",
    "libvirt",
    "bootc"
  ]
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[charly-vm on Agent Plugins Marketplace](https://pluginsmp.com/plugins/charly-vm)