# Agent instructions

* Files in `user/` map directly to `~/.config/`. The `link-user` script creates these symlinks.
  After creating new files in `user/`, tell me to rerun the `link-user` script.

## NixOS

The NixOS config for this laptop (hamac) and my servers is in `nixos/`.
Dependencies are pinned with npins; host-to-channel mappings are defined in `nixos/channels.toml`.

### Commands

* To inspect and edit pins use the `npins` CLI: `npins -d nixos/npins <command>`.
* To get the store path to a pin, use the `get-path` npins subcommand.
  For the Nixpkgs pin store paths `.envrc` defines the env vars `$nixos`, `$nixos_small`, `$nixos_unstable`.
* Avoid `nixos-option`.

## Documentation

* The Nixpkgs manual is in `<nixpkgs>/doc`.
* The NixOS manual is in `<nixpkgs>/nixos/doc/manual`.