diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..75607ef --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,21 @@ +# AGENTS.md + +## Build Commands +- `home-manager switch` - Apply home-manager configuration +- `nixos-generate -f <format> -c ./machines/<machine>.nix` - Generate NixOS image +- `nix-build` / `nix flake check` - Validate Nix expressions + +## Architecture +- **lib/**: Home-manager modules (common.nix is the base, imports via profiles) +- **machines/**: NixOS system configurations (oxygen=airgapped, helium/boron=laptops) +- **profiles/**: Compose lib modules for specific use cases (laptop.nix, darwin.nix) +- **pkgs/**: Custom Nix package derivations, exposed via overlay.nix +- **whisper-dictate/**: Standalone package for speech-to-text + +## Code Style +- Nix language with home-manager and NixOS modules +- Use `let ... in { }` pattern for local bindings +- Use `inherit` for importing attributes; prefer explicit imports +- Module arguments: `{ pkgs, lib, ... }:` +- Constants in lib/const.nix; nixpkgs pin in nixpkgs.nix +- Follow existing patterns when adding new modules or packages |