mirror of
https://github.com/nix-community/home-manager.git
synced 2026-10-02 19:49:18 +00:00
With `waitForNixStore = false` an agent is started through a launcher script so that macOS lists it under its own name in System Settings > Login Items & Extensions. Two properties of that launcher were fixed and unreachable from configuration: its base name (the agent's attribute name) and its interpreter (`/bin/sh`). Both matter on macOS. The name is what "Allow in the Background" shows, so a fleet-wide prefix such as `nix-` makes every Home Manager agent recognisable next to third-party items. The interpreter is the binary the system attributes the agent's process to; a store-resident shell attributes it to the launcher itself rather than to Apple's `/bin/sh`, which changes how the privacy prompts for folders like `~/Downloads` apply. Users who need either property today have to vendor this module. `launcher.name` (default: the attribute name, as before) and `launcher.shell` (default: `/bin/sh`, as before) make both configurable without changing any existing agent.