docs(installer): add linux shell persistence guidance

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: andyvand

AGENTS.md

@@ -14,6 +14,8 @@ This repo is the public installer entrypoint. Keep installer behavior stable acr
 
 ## Platform Critical
 - `install.sh` must use LF line endings. CRLF breaks WSL with `set: pipefail\r`.
+- On Linux/macOS, persist PATH via the active shell profile or a dedicated sourced snippet only; do not blanket-edit every rc file.
+- Do not depend on `source ~/.bashrc` in non-interactive installer flow.
 
 ## Smoke Test Baseline
 
@@ -23,4 +25,5 @@ This repo is the public installer entrypoint. Keep installer behavior stable acr
 ## Troubleshooting Fast Path
 - If version lookup fails, verify fallback-to-`beta` logic runs before any hard failure.
 - If WSL fails near shell options, check `install.sh` line endings first.
+- If install was launched with `sudo`, verify the installer targeted the intended user home/profile and did not silently persist into the wrong account.
 - When fixing one script, confirm the same behavior in the other script before closing work.

README.md

@@ -10,6 +10,8 @@ OCS (OpenCode Config Suites) quick installer for Multi Agents workflow, AI codin
 curl -fsSL https://raw.githubusercontent.com/andyvandaric/opencode-suites-installer/main/install.sh | bash
 ```
 
+Run it from your normal user shell. Do not wrap the installer in `sudo`, or profile/config writes may target the wrong home directory.
+
 Install specific version:
 
 ```bash