--- a/mrjunejune/README.md	Wed Aug 05 09:19:41 2026 -0700
+++ b/mrjunejune/README.md	Wed Aug 05 20:38:32 2026 -0700
@@ -28,6 +28,21 @@
   bazel run //mrjunejune:run_inference_stack
 ```
 
+For UI work, start the same Seobeo, Deita, inference bridge, and SSE path with
+deterministic mock responses. This mode does not require Copilot authentication
+or a LiteLLM key:
+
+```bash
+bazel run //mrjunejune:run_inference_stack -- --mock
+```
+
+Send `!hello`, `!response`, `!tool`, `!plan`, or `!error` to run a scripted
+event sequence. Edit `mrjunejune/inference/mock_responses.json` to add commands,
+ordered SSE event payloads, per-event timing, and response chunks. Custom event
+types pass through Seobeo and are published by the page as
+`mjj-jrpg-stream-event`, ready for future tool-call and plan-view components.
+Mock conversations use a separate database under the inference state directory.
+
 Keep `GITHUB_COPILOT_TOKEN_DIR` exported when starting the stack so it reads the
 same tokens. Without an override, both commands use
 `$XDG_STATE_HOME/mrjunejune/inference/litellm-copilot`, or