diff --git a/packages/vite-task-client/src/index.d.ts b/packages/vite-task-client/src/index.d.ts
index 92e16fcbd..821d0f676 100644
--- a/packages/vite-task-client/src/index.d.ts
+++ b/packages/vite-task-client/src/index.d.ts
@@ -52,8 +52,8 @@ export function getEnv(name: string, options?: {
  * this run's cache entry.
  *
  * A query that matches every env name, `{ prefix: '' }` or `*`, returns an
- * empty object and records nothing: read the task's own env from
- * `process.env` instead.
+ * empty object and records nothing. Ask for a narrower pattern instead, such
+ * as `{ prefix: 'VITE_' }`.
  *
  * Has no effect on `process.env`; the caller decides what to do with the
  * returned values. Returns an empty object when not running inside a runner.
diff --git a/packages/vite-task-client/src/index.js b/packages/vite-task-client/src/index.js
index c1e69ccf4..5bff8ec48 100644
--- a/packages/vite-task-client/src/index.js
+++ b/packages/vite-task-client/src/index.js
@@ -117,8 +117,8 @@ export function getEnv(name, options) {
  * this run's cache entry.
  *
  * A query that matches every env name, `{ prefix: '' }` or `*`, returns an
- * empty object and records nothing: read the task's own env from
- * `process.env` instead.
+ * empty object and records nothing. Ask for a narrower pattern instead, such
+ * as `{ prefix: 'VITE_' }`.
  *
  * Has no effect on `process.env`; the caller decides what to do with the
  * returned values. Returns an empty object when not running inside a runner.