Dominios de launchd: elegir entre un LaunchAgent o un LaunchDaemon y cargarlo con launchctl

Objetivo

Instalar un programa que macOS inicie automáticamente —al iniciar sesión el usuario (un LaunchAgent) o al arrancar sin sesión de usuario (un LaunchDaemon)— y gestionarlo con los subcomandos modernos de launchctl en lugar del par obsoleto load/unload.

Requisitos previos

Una sesión de Terminal; un programa referenciado mediante una ruta absoluta; privilegios de administrador/sudo solo para lo que se instale fuera del directorio personal propio. macOS 13 Ventura y posteriores (bootstrap/bootout/kickstart han sido la interfaz recomendada desde OS X 10.10, por lo que los comandos también funcionan en versiones anteriores).

Pasos

1. Elegir el dominio. Un LaunchAgent se ejecuta dentro de la sesión de un usuario concreto y puede acceder a la interfaz gráfica; pertenece al dominio gui/<uid> (inicio de sesión interactivo) o user/<uid> (segundo plano, sin GUI). Un LaunchDaemon se ejecuta como root sin contexto de usuario y pertenece al dominio system.
2. Elegir la ruta. ~/Library/LaunchAgents no requiere privilegios de administrador y solo se aplica a ese usuario. /Library/LaunchAgents se instala como administrador, pero sigue ejecutándose como el usuario que inicia sesión. /Library/LaunchDaemons se instala como administrador y se ejecuta como root sin importar quién haya iniciado sesión. /System/Library/LaunchAgents y /System/Library/LaunchDaemons están reservados para Apple y residen en el Signed System Volume; nunca deben añadirse archivos allí.
3. Escribir el plist con, como mínimo, un Label único en formato DNS inverso, un array ProgramArguments (no una cadena de shell), y RunAtLoad, KeepAlive o StartInterval.
4. Validar antes de cargar: plutil -lint /Library/LaunchDaemons/com.example.worker.plist.
5. Para un daemon, establecer la propiedad: sudo chown root:wheel y sudo chmod 644 sobre el plist.
6. Cargarlo: sudo launchctl bootstrap system /Library/LaunchDaemons/com.example.worker.plist (daemon), o launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.example.agent.plist (agente, ejecutado como ese usuario, sin sudo).
7. La persistencia proviene de la ubicación del archivo: launchd carga cada plist de /Library/LaunchDaemons al arrancar, y cada plist de los directorios de LaunchAgents al iniciar sesión. launchctl enable system/com.example.worker solo elimina una anulación disabled (establecida con launchctl disable, que también persiste tras reiniciar); launchctl print-disabled system enumera esas anulaciones.
8. Iniciarlo ahora, o reiniciar una instancia en ejecución: launchctl kickstart -k system/com.example.worker.
9. Para eliminarlo: sudo launchctl bootout system/com.example.worker antes de borrar el archivo plist.

Resultado esperado

launchctl print system/com.example.worker (o el destino gui/<uid>/... correspondiente para un agente) muestra state = running, el PID y el último estado de salida; un trabajo que no está cargado muestra en cambio «Could not find service».

Límites y base de verificación

Los roles de los directorios y la división por dominio provienen de la nota técnica de Apple sobre daemons y agentes; la sintaxis actual de los subcomandos bootstrap/bootout/enable/kickstart/print no está publicada por Apple como página web y se toma de una referencia de comandos. El par heredado launchctl load -w/unload -w todavía funciona en el macOS actual, pero no muestra los errores del momento de arranque de la misma manera y no es la interfaz documentada; en scripts nuevos conviene preferir bootstrap/bootout. Ni bootstrap ni bootout requieren reiniciar para surtir efecto.