diff --git a/docs/clawd.md b/docs/clawd.md
index 318dd0885..6babbad42 100644
--- a/docs/clawd.md
+++ b/docs/clawd.md
@@ -24,9 +24,17 @@ Start conservative:
 ## Prerequisites
 
 - Node **22+**
-- CLAWDIS installed: `npm install -g clawdis`
+- CLAWDIS available on PATH (recommended during development: from source + global link)
 - A second phone number (SIM/eSIM/prepaid) for the assistant
 
+From source (recommended while the npm package is still settling):
+
+```bash
+pnpm install
+pnpm build
+pnpm link --global
+```
+
 ## The two-phone setup (recommended)
 
 You want this:
@@ -121,7 +129,7 @@ Example:
 ## Sessions and memory
 
 - Session files: `~/.clawdis/sessions/{{SessionId}}.jsonl`
-- Session metadata (token usage, last route, etc): `~/.clawdis/sessions.json`
+- Session metadata (token usage, last route, etc): `~/.clawdis/sessions/sessions.json` (legacy: `~/.clawdis/sessions.json`)
 - `/new` starts a fresh session for that chat (configurable via `resetTriggers`)
 
 ## Heartbeats (proactive mode)