Using pekit

Pekit is the recipe-driven build and packaging tool for Peios. It reads declarative recipes, resolves sources and versions, plans the work before touching anything, then builds, tests, installs, packages, and publishes. This page is the map — what pekit does, the shape of a recipe, and where pekit sits in the toolchain that produces a Peios system.

Build and package a tiny "hello" program with pekit from an empty directory — a minimal pekit.toml, one pekit build, and a .peipkg you can inspect.

Reference for pekit's command surface: the seven commands, what each selects, its version behaviour, and how build/test/install/clean targets are named, selected, and ordered by their build dependencies.

The pekit command line: grammar, flag value forms, the global execution flags (--recipe, --workspace, --allow-unused, --dry-run, --quiet, --verbose, --json), their mutual-exclusion rules, the output renderers, exit codes, and how a recipe is located including remote recipe locators.