@telepath-computer/television 0.1.103 → 0.1.105

package/dist/skills/television/SKILL.md

@@ -127,6 +127,16 @@ Commands group into four intents:
 
 When the CLI rejects a command, follow the directive it prints rather than guessing flags.
 
+### Server operation notes
+
+`tv serve` starts the local server and requires `TELEVISION_ACP_AGENT=openclaw` or `TELEVISION_ACP_AGENT=hermes`. It preflights the selected ACP command on `PATH` and fails before listening if the binary is missing.
+
+`tv serve --persist` installs or refreshes the user system service. It captures the ACP-relevant shell environment into the service definition: exact `PATH`, canonical `TELEVISION_ACP_AGENT`, and matching `OPENCLAW_*` or `HERMES_*` variables. It validates the ACP command against that captured PATH before changing the installed service; rerun it after changing PATH, ACP agent env vars, the ACP agent install, or the Node/TV install. The refresh is non-atomic: if uninstall succeeds but install fails, fix the env and rerun `tv serve --persist`.
+
+`tv serve --persist-uninstall` removes the service and is equivalent to `tv stop`. Both are idempotent and print `{ "status": "stopped" }` whether or not a service was installed.
+
+`tv status` reports server health and, when supported, system service status.
+
 ## Read vs mutate
 
 Read commands print JSON. Workflow commands print plain text. Most mutation commands also print plain text, but `tv set-theme` is intentionally silent on success.