diff --git a/docs/README.md b/docs/README.md
index 6a3c9bd07..d8ff30247 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -18,7 +18,7 @@ Start here for setup, everyday usage, and deployment.
 | CLI reference | [`cli-reference.md`](./cli-reference.md) | Core CLI commands and common entrypoints |
 | In-chat commands | [`chat-commands.md`](./chat-commands.md) | Slash commands and periodic task behavior |
 | OpenAI-compatible API | [`openai-api.md`](./openai-api.md) | Local API endpoints, request format, and file uploads |
-| Deployment | [`deployment.md`](./deployment.md) | Docker and Linux service setup |
+| Deployment | [`deployment.md`](./deployment.md) | Docker, Linux service, and macOS LaunchAgent setup |
 
 ## Advanced Docs
 
diff --git a/docs/deployment.md b/docs/deployment.md
index 337739726..fe70d6835 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -103,11 +103,7 @@ On macOS, run the gateway as a `launchd` user agent so it starts automatically a
 which nanobot   # e.g. /Users/youruser/.local/bin/nanobot
 ```
 
-If you installed nanobot with `uv tool`, you may also want the Python path for `ProgramArguments`:
-
-```bash
-which python
-```
+Use this absolute `nanobot` path in `ProgramArguments` so the console script keeps the Python environment from your install method.
 
 **2. Create the LaunchAgent plist** at `~/Library/LaunchAgents/ai.nanobot.gateway.plist` (replace paths if needed):
 
@@ -121,7 +117,6 @@ which python
 
   <key>ProgramArguments</key>
   <array>
-    <string>/Users/youruser/.local/share/uv/tools/nanobot-ai/bin/python</string>
     <string>/Users/youruser/.local/bin/nanobot</string>
     <string>gateway</string>
     <string>--workspace</string>