Skip to content

arch-builder

Recipe card from the charly-distros plugin (Images — the deployable catalog).

Builder image for Arch Linux multi-stage builds. Counterpart to /charly-distros:fedora-builder — provides the same build capabilities (pixi, npm, cargo) plus AUR support via yay.

Property Value
Base arch
Layers pixi, nodejs, build-toolchain, yay
Builds pixi, npm, cargo, aur
Platforms linux/amd64
Registry ghcr.io/opencharly
  1. arch — base Arch Linux image
  2. pixi — pixi package manager (conda-forge Python environments)
  3. nodejs — Node.js and npm
  4. build-toolchain — gcc, cmake, autoconf, ninja, git, pkg-config
  5. yay — AUR helper (base-devel, git, yay binary)

When an Arch-based box has candies with pixi.toml, package.json, Cargo.toml, or aur: packages, the build system uses this image as the builder for multi-stage builds. Configured via the arch box’s builder: field (a map of build-type → builder-image):

charly.yml
arch:
builder:
pixi: arch-builder
npm: arch-builder
cargo: arch-builder
aur: arch-builder

The builder definitions themselves (pixi/npm/cargo/aur) live in the embedded builder: vocabulary — the same word is used intentionally because both maps key on the same slot (the build-type name).

Terminal window
charly box build arch-builder
charly shell arch-builder -c "pixi --version"
charly shell arch-builder -c "node --version"
charly shell arch-builder -c "yay --version"
Terminal window
charly shell arch-builder -c "pixi --version && node --version && yay --version && gcc --version"

MUST be invoked when the task involves the arch-builder box, Arch multi-stage builds, or AUR package building infrastructure. Invoke this skill BEFORE reading source code or launching Explore agents.

  • /charly-image:image — image family umbrella (candy: image entries — those carrying base:/from: — in charly.yml, build/validate/inspect/list)
  • /charly-build:build — the embedded build vocabulary (distros, builders, init-systems)