commit 9af07bedff78dee5e74371f850c344d87d211f26 Author: Jelle Spreeuwenberg Date: Fri Apr 17 00:27:22 2026 +0200 Initial commit diff --git a/.codex b/.codex new file mode 100644 index 0000000..e69de29 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2e0bac8 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +.agents/ +.claude/ +.codex/ +.opencode/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..d7d4353 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,39 @@ +# Repository Guidelines + +## Project Structure & Module Organization +This repository is a Den-based NixOS flake. `flake.nix` evaluates `./modules` through `import-tree`, so normal `.nix` files under `modules/` are auto-imported. + +- `modules/hosts/` contains host-specific composition and hardware data for `polaris` and `orion`. +- `modules/features/` contains aspects such as desktop, shell, services, and Neovim. +- `modules/profiles/` holds higher-level bundles such as `workstation.nix`. +- `modules/users/` defines user metadata and per-user behavior. +- `modules/secrets/` wires `sops-nix` and stores the encrypted `secrets.yaml`. +- `.agents/den/` is a local checkout of Den with source, docs, and examples. + +Keep host files thin. Shared behavior belongs in `modules/features/` or `modules/profiles/`. +When Den behavior is unclear, read `.agents/den/docs/`, `.agents/den/modules/`, and `.agents/den/templates/ci/` before guessing. + +## Build, Test, and Development Commands +Run commands from the repository root. + +- `nix build .#nixosConfigurations.polaris.config.system.build.toplevel --show-trace`: evaluate and build the Polaris system. +- `nix build .#nixosConfigurations.orion.config.system.build.toplevel --show-trace`: evaluate and build the Orion system. +- `nixos-rebuild build --flake .#`: use the standard rebuild path without activating it. +- `nix fmt`: format Nix files using the flake-provided formatter. +- `nix eval .#nixosConfigurations..config.