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.

335 cards across 38 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-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-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) 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 and the maximal non-browser openclaw-full.

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

Section titled “charly-selkies”

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

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.