# 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