distros/skills/cachyos-pacstrap/SKILL.md
Bootstrap-from-scratch CachyOS rootfs via pacstrap inside a privileged builder. Builds end-to-end as of charly 2026.141.1850 (shared pacstrap renderer emits Architecture + SigLevel); retained for offline/air-gapped builds. Lives in the overthinkos/cachyos submodule (box/cachyos). MUST be invoked before building or troubleshooting cachyos-pacstrap.
npx skillsauth add overthinkos/overthink-plugins cachyos-pacstrapInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Bootstrap-from-scratch CachyOS root filesystem, built via pacstrap inside the
privileged /charly-distros:cachyos-pacstrap-builder container
(from: builder:pacstrap, bootstrap_builder_image: cachyos-pacstrap-builder).
Lives in
overthinkos/cachyos(git submodule atbox/cachyos). Build:charly -C box/cachyos box build cachyos-pacstrap.
The canonical CachyOS base (/charly-distros:cachyos) pulls the upstream-published
OCI image from Docker Hub — that is the recommended path and the one the CachyOS
project itself uses. This pacstrap variant exists for offline / air-gapped
builds and as a worked example of the from: builder:pacstrap +
bootstrap_builder_image: pattern.
Earlier this path was unusable: the privileged pacstrap step rejected the
CachyOS x86_64_v3 packages (package architecture is not valid) and, on the
VM path, tripped GPGME signature checks (GPGME error: No data). Fixed as of
charly 2026.141.1850 by the shared renderPacstrapExtraConf helper (charly/build.go,
used by both runPrivilegedBootstrap and charly/vm_bootstrap.go):
[options] Architecture = x86_64 x86_64_v3 directive from the
cachyos-v3 repos' microarch token, so pacman accepts linux-cachyos etc.;SigLevel — the VM bootstrap path previously open-coded
the loop and dropped SigLevel, so SigLevel = Never cachyos repos fell
back to signature-required and GPGME failed. Both paths now share one renderer
(R3), so they can't diverge again.Verified live: charly -C box/cachyos box build cachyos-pacstrap produces a
rootfs with linux-cachyos (%ARCH% = x86_64_v3) installed. (Requires an charly
with this fix — newer than the published release.) The Docker-Hub /charly-distros:cachyos
base is still the faster default (no privileged build).
| Property | Value |
|----------|-------|
| From | builder:pacstrap |
| bootstrap_builder_image | cachyos-pacstrap-builder |
| Distro | cachyos, arch |
| Build | pac |
| Home repo | overthinkos/cachyos (box/cachyos) |
The cachyos distro config (pacstrap base packages, CachyOS keyring
F3B607488DB35A47, mirrorlist, cachyos* repos) lives in the main repo's
build.yml and is flat-imported by the submodule (a bare-string import: item).
/charly-distros:cachyos — the recommended Docker-Hub base/charly-distros:cachyos-pacstrap-builder — the privileged builder it uses/charly-vm:cachyos — the VM built via the same pacstrap pathMUST be invoked before building or debugging the CachyOS pacstrap rootfs. Invoke BEFORE reading source code or launching Explore agents.
tools
OpenCharly CLI (charly) binary installed into container/VM images for in-container use. Use when working with charly binary deployment inside containers, native D-Bus support, or the full charly toolchain (charly binary + virtualization + gocryptfs + socat).
development
Operator CachyOS workstation profile — a kind:local template + target:local deploy that installs the full dev stack (30 candies) onto a CachyOS host via ShellExecutor. Lives in the overthinkos/cachyos submodule. MUST be invoked before editing or applying the charly-cachyos workstation profile.
tools
Fedora box with the full charly toolchain using shared candies. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Same candy list as charly-arch. Includes NVIDIA GPU runtime. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-fedora box.
tools
Arch Linux box with the full charly toolchain. Rootless-first — runs as uid=1000 with passwordless sudo (no root, no cap_add: ALL). Composes /charly-coder:charly-mcp so the box is reachable as an MCP gateway on port 18765. NVIDIA GPU runtime composed in. MUST be invoked before building, deploying, configuring, or troubleshooting the charly-arch box.