diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.md
index c167627257..f452f15916 100644
--- a/codex-rs/app-server/README.md
+++ b/codex-rs/app-server/README.md
@@ -1639,12 +1639,13 @@ When `threadId` is provided, app feature gating (`Feature::Apps`) is evaluated u
 
 `app/list` returns after both accessible apps and directory apps are loaded. Set `forceRefetch: true` to bypass app caches and fetch fresh data from sources. Cache entries are only replaced when those refetches succeed.
 
-The server also emits `app/list/updated` notifications whenever either source (accessible apps or directory apps) finishes loading. Each notification includes the latest merged app list.
+The server also emits `app/list/updated` notifications whenever either source (accessible apps or directory apps) finishes loading. Each notification includes the latest merged app list and `isFinal`, which is `false` for interim updates and `true` once both sources have loaded.
 
 ```json
 {
   "method": "app/list/updated",
   "params": {
+    "isFinal": true,
     "data": [
       {
         "id": "demo-app",