feat: 0.1.0

README.md

@@ -55,3 +55,59 @@ Use Nix or Cargo:
 nix develop -c cargo test
 nix develop -c cargo run
 ```
+
+## Nix package consumption
+
+This repo is a flake and exposes `codex-controller-loop` under `packages` plus an exported overlay.
+
+From another flake:
+
+```nix
+{
+  inputs.codex-controller-loop.url = "github:your-org/codex-controller-loop";
+
+  outputs = { self, nixpkgs, codex-controller-loop, ... }:
+  let
+    system = "x86_64-linux";
+  in
+  {
+    packages.${system}.default = codex-controller-loop.packages.${system}.default;
+  };
+}
+```
+
+Through the overlay:
+
+```nix
+{
+  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+  inputs.codex-controller-loop.url = "github:your-org/codex-controller-loop";
+
+  outputs = { self, nixpkgs, codex-controller-loop, ... }:
+  let
+    system = "x86_64-linux";
+    pkgs = import nixpkgs {
+      inherit system;
+      overlays = [ codex-controller-loop.overlays.default ];
+    };
+  in
+  {
+    packages.${system}.default = pkgs.codex-controller-loop;
+  };
+}
+```
+
+Non-flake usage also works:
+
+```bash
+nix-build
+nix-env -f . -iA codex-controller-loop
+```
+
+## Release generation
+
+```bash
+python scripts/release-orchestrator.py --version 0.1.0 --target x86_64-unknown-linux-gnu
+```
+
+Generated artifacts are written to a canonical `dist/` layout and tracked by `dist/index.json` (legacy alias: `dist/{distribution_contract_version}/index.json` until 2026-07-01).