docs(plugin): explain terminal execution and verification

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

1 files changed, 6 insertions, 1 deletions

diff --git a/plugin/README.md b/plugin/README.md
index c0135dc..37eb0a6 100644
--- a/plugin/README.md
+++ b/plugin/README.md
@@ -20,7 +20,12 @@ Open a `.cps` file. The language mode should show **CIE Pseudocode**.
 - Automatic Tab indentation and outdent for block keywords.
 - **Format Selection**: select code, then press **Cmd+K, Cmd+F** on macOS or **Ctrl+K, Ctrl+F** on Windows/Linux. Only indentation changes.
 - Colored `()` and `[]` pairs; unmatched brackets turn red. Quotes and comments are ignored.
+- **Run Pseudocode File in Terminal**: click the play button at the top right. The current file is saved, then run with `cpsc ... -r`; selections are ignored. New files ask for a save location first.
 
-Use uppercase keywords, `<-` for assignment and `//` for comments. Support matches the current compiler. Compile and run with `cpsc` separately.
+Install `cpsc` with execution support and add it to PATH, or set **CIE Pseudocode: Compiler Path** (`cie-pseudocode.compilerPath`) to its full executable path. On Windows, use `cpsc.exe` with PowerShell or Command Prompt; on Linux/macOS, use bash or zsh.
+
+The terminal takes focus so you can answer `INPUT`. Relative file paths use the file's workspace root, or its own directory when no workspace is open. The terminal is reused; stop a running program with **Ctrl+C** before running again.
+
+Use uppercase keywords, `<-` for assignment and `//` for comments. Support matches the current compiler.
 
 See [examples/highlighting.cps](examples/highlighting.cps) for an example.