Skip to content
OpenCharly

Recipe cards

Every candy, box, verb and subsystem in OpenCharly ships a recipe card: the vocabulary the compiler runs on, and what an agent loads as a skill. Each card is a dedicated page describing what the thing does, how it is made, and how it should behave — the same cards an agent loads while working on the project, published here unchanged.

363 cards across 43 plugins, in four groups.

Commands — runtime CLI verbs

Section titled “Commands — runtime CLI verbs”

charly-agent

Section titled “charly-agent”

The charly tui terminal UI for the agent control plane (candy/plugin-agent).

charly-authoring

Section titled “charly-authoring”

The charly box add-candy/cat/fetch/labels/refresh/rm-candy/set/write authoring verbs served by candy/plugin-authoring.

charly-automation

Section titled “charly-automation”

Automation/customization knobs — tmux verb, host-side wrappers (alias, udev), topic flags (encryption, sidecars, openclaw deployment).

charly-bpf

Section titled “charly-bpf”

The charly bpf eBPF program surface served by candy/plugin-bpf.

charly-build

Section titled “charly-build”

Build/authoring CLI verbs — build, generate, list, inspect, merge, new, pull, validate, secrets, settings, migrate, charly-mcp-cmd.

charly-cache

Section titled “charly-cache”

The charly cache git-ref cache operator surface — status, clear, refresh, bypass.

charly-candy-cli

Section titled “charly-candy-cli”

The charly candy authoring surface served by candy/plugin-candy.

charly-cardwire

Section titled “charly-cardwire”

The charly cardwire surface served by candy/plugin-cardwire.

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-feature

Section titled “charly-feature”

The charly feature / charly box feature Agent Driven Evaluation surface — run a deployment’s baked plan as acceptance tests with agent grading.

charly-pipeline

Section titled “charly-pipeline”

The charly pipeline agent/workflow engine — plan agent stage, plan executor, deterministic probe verbs, template/frontmatter rendering.

charly-pod-verbs

Section titled “charly-pod-verbs”

Pod-lifecycle CLI verbs served by candy/plugin-pod — cp (host<->container copy), volume (list/reset named volumes), restart.

charly-review

Section titled “charly-review”

The charly review read-only GitHub PR review engine — verb:pr tools, the chat-completions review loop, verdict emission.

Kinds — schema authoring

Section titled “Kinds — schema authoring”

charly-fireactions

Section titled “charly-fireactions”

Fireactions — GitHub Actions runners on Firecracker microVMs: the pool model where a runner is a microVM, the containerd snapshotter constraint that decides whether a pool needs a spare block device, the opencharly fork and why it is pinned, the host layer that installs the VMM and kernel, and the beds that gate the host and the runner.

charly-firecracker

Section titled “charly-firecracker”

Schema authoring reference for the firecracker microVM substrate — the root-drive + kernel artefact, the VMM API surface (what it answers and what it rejects), and the boot recipe that needs no TAP, no root and no network.

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: kubernetes — Kustomize manifests, cluster probes via the kube: check verb, and the helm words (helm-release install step + helm: check verb).

charly-kubevirt

Section titled “charly-kubevirt”

Schema authoring for the kubevirt: deploy substrate (the 7th) — kind: kubevirt templates and kubevirt:/target: kubevirt deploys, the VirtualMachine CR lifecycle (DataVolume, runStrategy, VMI Ready + AgentConnected, managed virtctl port-forward), the out-of-process kubevirt: check verb, and the pinned KubeVirt + CDI platform install.

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-agentteams

Section titled “charly-agentteams”

Self-contained skills for the AgentTeams multi-agent stack (CachyOS base): the decomposed agentteams box — minio, matrix/tuwunel, element, higress, controller — on pod and vm substrates, plus the compiled-in charly agentteams management CLI.

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).

charly-comfyui

Section titled “charly-comfyui”

Self-contained skills for running the comfyui image-generation/diffusion image.

charly-crabbox

Section titled “charly-crabbox”

Self-contained skills for the crabbox image family: the Crabbox CLI (layer-crabbox), the local Node/PostgreSQL coordinator (pod-crabbox-coordinator) and the crabbox: check verb (plugin-crabbox) — the fully-local remote-execution control plane.

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.

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.

charly-jupyter

Section titled “charly-jupyter”

Self-contained skills + MCP wiring for the jupyter image family (jupyter, jupyter-ml, jupyter-ml-notebook, unsloth-studio).

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.

charly-openwebui

Section titled “charly-openwebui”

Self-contained skills for the openwebui chat-frontend image.

charly-punktfunk

Section titled “charly-punktfunk”

Self-contained skills for the punktfunk streaming-host image family (CachyOS base): the punktfunk/1 QUIC host daemon, its browser console and its plugin runner, installed from unom’s signed pacman repo with a headless Sway compositor for the host to drive.

charly-qdrant

Section titled “charly-qdrant”

Self-contained skills for the Qdrant vector-search service family: the pinned static-musl service candy (REST 6333 / gRPC 6334, persistent storage, admin API-key auth from the credential store) and the charly qdrant management CLI plus the declarative qdrant: check verb.

charly-selkies

Section titled “charly-selkies”

Self-contained skills + MCP wiring for the selkies-desktop family (Wayland desktop in a container with VNC + Chrome).

charly-strata

Section titled “charly-strata”

The Strata family — the inference-engine layer, its cachyos-based image, the charly strata management CLI, and both beds: the deterministic GPU-free one and the exclusive-host GPU one.

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.

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).

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.