Project-Kiln/README.md

Project Kiln

Private implementation of the CLI-first Arch gaming OS. Kiln and every kiln-* identifier are temporary repository-local names, not public compatibility promises.

Status

Phases 0–3 are complete: repository gates, shared contracts, native discovery/execution, and read-only Steam discovery. Phase 4 adds Steam launch planning and representative native/Proton execution. The Steam commands below currently read metadata only; they do not start Steam or launch games.

Current proof

The workspace contains the shared Rust core, native and read-only Steam adapters, and CLI. Local development, verification, and the minimum supported compiler are pinned to Rust 1.97.1:

kiln doctor
kiln doctor --json
kiln list
kiln search <query>
kiln info <id-or-name>
kiln launch <id-or-name> --dry-run
kiln list --provider steam
kiln search <query> --provider steam
kiln scan --provider steam
kiln info steam:<app-id>
kiln config defaults
kiln config validate
kiln config explain --json

Run the complete local gate with make check. Run deterministic repository and Rust gates without the network-backed audit with make verify. Run only the environment-independent repository checks with make static. Run the separately versioned, network-backed dependency advisory/license/source audit with make audit. Rust 1.97.1 is pinned.

Gitea stores the source repository but does not compile or test it. Local evidence is recorded before pushes and releases.

The active specification is under docs/spec/. Start with docs/spec/00_SPEC_INDEX.md; the archived monolith is intentionally excluded.

Local Codex CLI work starts with AGENTS.md. Native manifest setup is documented in docs/phase-2/native-manifests.md; completed Steam discovery evidence is under docs/phase-3/.