diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 704ee91..4d9beb3 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -6,6 +6,8 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
 
 - `just check` - lint (ruff --fix + format), typecheck (pyright), test (pytest)
 - `just lint` / `just typecheck` / `just test` - individual steps
+- `just run` - start the server (`python -m mudlib`)
+- `just debug` - start with debug logging
 
 ## Project Layout