diff --git a/README.md b/README.md
index 2153bcf..83cfae4 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,9 @@ Skills are domain-specific knowledge modules in `OLLIE_SKILLS_PATH` (default: `~
 
 ## Session lifecycle
 
-`NewAgentCore` creates `/tmp/ollie/{sessionID}` at session start. `Core.Close()` removes it. The 9P server instantiates the execute server and elevation broker at the daemon level; sessions share them with per-session state via the tool registry.
+The 9P server (`olliesrv`) is the session manager. It instantiates the execute server, elevation broker, and tool/skill registries at daemon level. Sessions are created, queried, and controlled via the 9P filesystem — all agent interaction uses the `ollie-9p` client internally.
+
+`NewAgentCore` handles per-session state: message history, tool call routing, compaction, and hooks. `Core.Close()` tears down resources when a session is killed.
 
 ## License