diff --git a/AGENTS.md b/AGENTS.md index df25914..fdfce08 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,4 +7,10 @@ This project is expected to run locally using split systemd user services: When working on this project, assume the session runtime owner is long-lived and separate from the autoreloading UI/API process. Browser disconnects and UI/API restarts should not stop active Pi sessions. -If you make changes that affect `src/server/sessiond.ts`, session runtime ownership, the session daemon protocol, or any code path only loaded by the session daemon, inform the user that `pi-web-sessiond.service` must be manually restarted. Changes to the web/API/UI side generally only require the `pi-web-ui-dev.service` autoreload/restart path. +If you make changes that affect `src/server/sessiond.ts`, session runtime ownership, the session daemon protocol, or any code path only loaded by the session daemon, inform the user that `pi-web-sessiond.service` must be manually restarted and give them this command: + +```bash +systemctl --user restart pi-web-sessiond.service +``` + +Changes to the web/API/UI side generally only require the `pi-web-ui-dev.service` autoreload/restart path. diff --git a/README.md b/README.md index b944464..add6fdf 100644 --- a/README.md +++ b/README.md @@ -94,7 +94,13 @@ journalctl --user -u pi-web-sessiond.service -f journalctl --user -u pi-web-ui-dev.service -f ``` -Because `sessiond` is intentionally not watched or restarted automatically, code changes that affect `src/server/sessiond.ts` or session runtime ownership require manually restarting `pi-web-sessiond.service`. Restarting only the UI dev service is enough for changes in the web/API/UI processes. +Because `sessiond` is intentionally not watched or restarted automatically, code changes that affect `src/server/sessiond.ts` or session runtime ownership require manually restarting `pi-web-sessiond.service`: + +```bash +systemctl --user restart pi-web-sessiond.service +``` + +Restarting only the UI dev service is enough for changes in the web/API/UI processes. For deployment: