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–4 are complete: repository gates, shared contracts, native discovery/execution, Steam discovery, typed Steam launch planning, and representative native/Proton execution. Phase 5 proves the minimal graphical session and recovery path.

Current proof

The workspace contains the shared Rust core, native and 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 launch steam:<app-id> --dry-run
kiln launch 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/; completed Steam execution evidence is under docs/phase-4/.