Recipe cards
Every candy, box, verb and subsystem in OpenCharly ships a recipe card — a dedicated page describing what it does, how it is made, and how it should behave. The cards are the same ones an agent loads as skills while working on the project, published here unchanged.
294 cards across 25 plugins, in four groups.
Commands — runtime CLI verbs
Section titled “Commands — runtime CLI verbs”charly-automation
Section titled “charly-automation”Automation/customization knobs — tmux verb, host-side wrappers (alias, udev), topic flags (encryption, sidecars, openclaw deployment).
charly-build
Section titled “charly-build”Build/authoring CLI verbs — build, generate, list, inspect, merge, new, pull, validate, secrets, settings, migrate, charly-mcp-cmd.
- build
- charly-mcp-cmd
- docs
- generate
- inspect
- list
- merge
- migrate
- new
- pull
- reconcile
- secrets
- settings
- validate
charly-check
Section titled “charly-check”Live-container evaluation and probe verbs — charly check orchestrator + per-protocol live probes (cdp, wl, wl-overlay, dbus, vnc, spice, libvirt, record).
charly-core
Section titled “charly-core”Runtime/lifecycle CLI verbs — start, stop, restart, charly-status, logs, shell, ssh, deploy, charly-update, remove, charly-config, cmd, charly-version, charly-doctor.
- charly-config
- charly-doctor
- charly-status
- charly-update
- charly-version
- clean
- cmd
- deploy
- logs
- remove
- service
- shell
- ssh
- start
- stop
Kinds — schema authoring
Section titled “Kinds — schema authoring”charly-image
Section titled “charly-image”Schema authoring reference for kind: box and kind: candy — charly.yml composition, task verbs, validation.
charly-kubernetes
Section titled “charly-kubernetes”Schema authoring for kind: k8s — Kustomize manifests + cluster probes via charly check k8s.
charly-local
Section titled “charly-local”Schema authoring for kind: local — local templates, ssh-host targets, managed ssh-config fragment.
charly-pod
Section titled “charly-pod”Schema authoring for kind: pod and kind: deploy — charly.yml shapes, nested deploys, sidecars.
charly-vm
Section titled “charly-vm”Schema authoring reference for kind: vm + bootc VM catalog — libvirt/QEMU backends, cloud_image vs bootc sources.
Images — the deployable catalog
Section titled “Images — the deployable catalog”charly-coder
Section titled “charly-coder”Self-contained skills + MCP wiring for charly coder/dev images (arch-coder, debian-coder, fedora-coder, ubuntu-coder, charly-arch).
- arch-coder
- asciinema
- build-toolchain
- charly-arch
- charly-mcp
- claude-code
- codex
- debian-coder
- dev-tools
- devops-tools
- direnv
- docker-ce
- fedora-coder
- forgecode
- gemini
- gh
- github-actions
- golang
- google-cloud
- google-cloud-npm
- grafana-tools
- kimi
- kubernetes-layer
- language-runtimes
- nodejs
- oracle
- pre-commit
- rust
- sshd
- typst
- ubuntu-coder
- uv
charly-comfyui
Section titled “charly-comfyui”Self-contained skills for running the comfyui image-generation/diffusion image.
charly-distros
Section titled “charly-distros”Base OS images and hardware runtime — arch, fedora, debian, ubuntu, aurora, bazzite, GPU runtime (nvidia/cuda/rocm), bootc bootstrap, per-distro builders.
- agent-forwarding
- arch
- arch-aur-test
- arch-builder
- arch-pac-test
- arch-test
- cachyos
- cachyos-pacstrap
- cachyos-pacstrap-builder
- charly-fedora
- cloud-init
- container-nesting
- cuda
- debian
- debian-builder
- debian-debootstrap
- debian-debootstrap-builder
- fedora
- fedora-builder
- fedora-nonfree
- fedora-test
- github-runner
- githubrunner
- nvidia
- nvidia-layer
- qemu-guest-agent
- rocm
- rpmfusion
- ubuntu
- ubuntu-builder
- ubuntu-debootstrap
- ubuntu-debootstrap-builder
- valkey-test
- workspace-mount
charly-filebrowser
Section titled “charly-filebrowser”Self-contained skills for the filebrowser image (web-based file management on top of an charly volume).
charly-hermes
Section titled “charly-hermes”Self-contained skills for the hermes agent image (hermes + hermes-playwright variants).
charly-immich
Section titled “charly-immich”Self-contained skills for the immich photo-management image (immich + immich-ml variants).
charly-infrastructure
Section titled “charly-infrastructure”Infrastructure services and system layers — postgresql, redis, valkey, vectorchord, k3s cluster, traefik, supervisord, tailscale, gocryptfs, virtualization, dbus-layer, tmux-layer.
- dbus-layer
- gnupg
- gocryptfs
- k3s
- k3s-agent
- k3s-server
- keepassxc
- keepassxc-keyring
- postgresql
- redis
- socat
- sqlite
- ssh-client
- supervisord
- tailscale
- tailscale-up
- testapi
- tmux-layer
- traefik
- valkey
- vectorchord
- virtualization
charly-jupyter
Section titled “charly-jupyter”Self-contained skills + MCP wiring for the jupyter image family (jupyter, jupyter-ml, jupyter-ml-notebook, unsloth-studio).
- jupyter
- jupyter-layer
- jupyter-mcp
- jupyter-ml
- jupyter-ml-layer
- jupyter-ml-notebook
- llama-cpp
- notebook-finetuning
- notebook-llm-on-supercomputers
- notebook-ollama
- notebook-openrouter
- notebook-templates
- unsloth
- unsloth-studio
- unsloth-studio-layer
charly-languages
Section titled “charly-languages”Programming language runtimes and package managers — python, python-ml, pixi (others like golang/rust/nodejs live in charly-coder).
charly-ollama
Section titled “charly-ollama”Self-contained skills for running the ollama LLM-server image.
charly-openclaw
Section titled “charly-openclaw”Self-contained skills for the openclaw image family (CachyOS base): the headless openclaw gateway and the maximal non-browser openclaw-full.
- clawhub
- openclaw
- openclaw-desktop
- openclaw-full
- openclaw-full-layer
- openclaw-full-ml-layer
- openclaw-layer
charly-openwebui
Section titled “charly-openwebui”Self-contained skills for the openwebui chat-frontend image.
charly-selkies
Section titled “charly-selkies”Self-contained skills + MCP wiring for the selkies-desktop family (Wayland desktop in a container with VNC + Chrome).
- a11y-tools
- camsnap
- chrome
- chrome-devtools-mcp
- chrome-sway
- desktop-fonts
- fastfetch
- ffmpeg
- heroic
- kde-selkies
- kde-shell
- labwc
- libnotify
- pavucontrol
- pipewire
- selkies
- selkies-core
- selkies-desktop-layer
- selkies-kde
- selkies-kde-desktop
- selkies-kde-nvidia
- selkies-labwc
- selkies-labwc-nvidia
- steam
- sway
- sway-browser-vnc
- sway-desktop
- sway-desktop-vnc
- swaync
- thunar
- wacli
- waybar
- waybar-labwc
- wayvnc
- wf-recorder
- wl-overlay-layer
- wl-record-pixelflux
- wl-screenshot-grim
- wl-screenshot-pixelflux
- wl-tools
- xdg-portal
- xfce4-terminal
- xterm
charly-tools
Section titled “charly-tools”CLI utilities and the charly binary deploy artifacts — ripgrep, himalaya, whisper, nano-pdf, summarize, ordercli, gogcli, sherpa-onnx, plus the charly binary deployment skill.
- blogwatcher
- charly
- cue
- docs-site
- gifgrep
- gogcli
- goplaces
- himalaya
- mcporter
- nano-pdf
- ordercli
- ripgrep
- sag
- sherpa-onnx
- songsee
- summarize
- vscode
- whisper
- xurl
- yay
charly-versa
Section titled “charly-versa”Self-contained skills + MCP wiring for the versa image — a marimo notebook environment (marimo + Airflow + OSM/GTFS analytics + martin vector tiles + five PMTiles generation pipelines: tippecanoe / gpq-tiles / DuckDB ST_AsMVT / DuckDB → freestiler / Shortbread-via-Tilemaker, plus PMTiles Viewer SPA on port 28001 + VersaTiles Frontend on port 28002 + versatiles serve as second tile server on port 28090).
- airflow-layer
- debug-tools-layer
- maplibre-versatiles-styler
- maputnik-layer
- marimo-layer
- marimo-mcp
- notebook-osm
- osm-tools-layer
- pmtiles-viewer
- shortbread
- sway-browser-ecovoyage
- versa
- versatiles
- versatiles-fonts
- versatiles-frontend
- versatiles-style
Development — contributor internals
Section titled “Development — contributor internals”charly-internals
Section titled “charly-internals”Development internals for charly contributors — Go source map, install-plan IR, capabilities/OCI labels, vm-spec, libvirt/cloud-init renderers, cutover-policy, strict-policy, disposable, ovmf, generate-source, skill maintenance, and the agents/workflows/teams guide.