diff --git a/README.md b/README.md
index 024a146..3679870 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,12 @@
 
 This directory is the home of the standalone Linux client repository.
 
+The current development shell connects to the server readiness endpoint and
+provides an administrator login gate. The browser/dev client keeps its bearer
+session in memory only; the native AppImage integration must replace that
+temporary behavior with the Linux kernel keyring before persistent client
+authentication is considered complete.
+
 The client is a Svelte-based control surface distributed as an x86-64 AppImage. It communicates with `trixie-server` through the documented versioned HTTP and authenticated WebSocket interfaces.
 
 Implementation has not started. See the parent workspace's `PLAN.md`, `TODO.md`, and `AGENTS.md` before beginning work.