diff --git a/README.md b/README.md
index b77542c..f6674e0 100644
--- a/README.md
+++ b/README.md
@@ -2,20 +2,35 @@
 
 Acme frontend for AnviLLM - provides a graphical interface for managing LLM sessions, beads, and messaging.
 
-## Usage
+## Installation
 
 ```sh
 mk install
+```
+
+## Usage
+
+```sh
 Assist
 ```
 
+Middle-click `Assist` in Acme to launch.
+
+**Namespaces:** Connect to different anvilsrv instances via `$NAMESPACE`:
+```sh
+NAMESPACE=/tmp/ns.$USER.:1 Assist
+```
+
 ## Features
 
 - Session management (create, list, control)
 - Beads task tracking integration (via 9beads)
-- Inter-agent messaging
-- Inbox/archive views
-- Daemon control
+- Inter-agent messaging with inbox/archive views
+- Daemon control and recovery
+
+**Daemon recovery:** If the daemon crashes but tmux sessions are still running, middle-click `Recover` to reload all session data into the server and continue working.
+
+**Terminal attach:** Middle-click a session to attach its tmux session in a terminal. Set `ANVILLM_TERMINAL` to configure the terminal command (default: `foot`).
 
 ## Dependencies