diff --git a/packages/website/src/content/docs/aether/built-in-servers/subagents.mdx b/packages/website/src/content/docs/aether/built-in-servers/subagents.mdx
index 044198f0..53ccfe86 100644
--- a/packages/website/src/content/docs/aether/built-in-servers/subagents.mdx
+++ b/packages/website/src/content/docs/aether/built-in-servers/subagents.mdx
@@ -18,7 +18,7 @@ The `subagents` server lets one agent delegate work to other configured agents.
 }
 ```
 
-`--project-root` loads `.aether/settings.json` from that directory. `--dir` is accepted as an alias. When omitted, the server uses `.`.
+`--project-root` loads `.aether/settings.json` from that directory. `--dir` is accepted as an alias. When omitted, the built-in in-memory server uses the workspace root; the standalone `subagents-mcp` binary defaults to the current directory.
 
 ## Available sub-agents
 
diff --git a/packages/website/src/content/docs/aether/settings/mcp-servers.mdx b/packages/website/src/content/docs/aether/settings/mcp-servers.mdx
index 3dfe8519..7cd2c25f 100644
--- a/packages/website/src/content/docs/aether/settings/mcp-servers.mdx
+++ b/packages/website/src/content/docs/aether/settings/mcp-servers.mdx
@@ -188,9 +188,9 @@ For `http` and `sse` servers that require OAuth, Aether defaults to dynamic clie
 | `coding`    | File I/O, bash, grep/find, web fetch/search, and LSP-backed coding tools | `--root-dir <path>`, repeat `--rules-dir <path>`, `--permission-mode always-allow\|auto\|always-ask`, `--disable-lsp` |
 | `skills`    | Skill discovery, slash-command prompts, and rules                        | Required: repeat `--dir <path>`                                                                                         |
 | `tasks`     | Hierarchical task management                                             | Optional `--dir <base>` for persistent storage                                                                        |
-| `subagents` | Spawn child agents from loaded settings                                  | `--project-root <path>` (alias: `--dir`, defaults to `.`)                                                             |
+| `subagents` | Spawn child agents from loaded settings                                  | `--project-root <path>` (alias: `--dir`; defaults to the workspace root)                                              |
 | `survey`    | Structured human-in-the-loop questions                                   | No args                                                                                                               |
-| `plan`      | Plan prompt and markdown plan review                                     | Optional `--prompt-file <path>`, plus optional trailing submit command                                                |
+| `plan`      | Plan prompt and markdown plan review                                     | Optional `--plans-dir <path>`, `--prompt-file <path>`, plus optional trailing submit command                          |
 
 <CardGrid>
   <LinkCard
diff --git a/packages/website/src/content/docs/libraries/typescript-sdk.mdx b/packages/website/src/content/docs/libraries/typescript-sdk.mdx
index fd2367d9..aa670c08 100644
--- a/packages/website/src/content/docs/libraries/typescript-sdk.mdx
+++ b/packages/website/src/content/docs/libraries/typescript-sdk.mdx
@@ -135,7 +135,7 @@ Because `aether headless` exits non-zero on a failed turn, `runHeadless()` **rej
 | `settingsFile`  | Path to an alternate settings JSON file.                                                             |
 | `systemPrompt`  | Additional system prompt text.                                                                       |
 | `output`        | `"text"`, `"pretty"`, or `"json"`. Defaults to `"text"`. See [output formats](/aether/running/headless/#output-formats). |
-| `events`        | Event kinds to emit (only meaningful with `output: "json"`). See [event filtering](/aether/running/headless/#event-filtering).   |
+| `events`        | Event kinds to emit (applies to any output format). See [event filtering](/aether/running/headless/#event-filtering).   |
 | `verbose`       | Verbose diagnostic logging to stderr.                                                                |
 | `providers`     | Provider connection overrides, such as custom Bedrock endpoints or auth behavior.                    |
 | `traceContext`  | A remote W3C `traceparent` with optional `tracestate`, or a standalone `traceId`. See [Telemetry](/aether/settings/telemetry/#correlating-sdk-runs). |