diff --git a/README-en.md b/README-en.md
index 4c78cbd..55d0cf6 100644
--- a/README-en.md
+++ b/README-en.md
@@ -99,7 +99,7 @@ Deep Code supports multimodal input — you can paste images from the clipboard
 
 ### How to automatically send a Slack message after a task completes?
 
-Write a shell notification script that calls a Slack webhook, then set the `notify` field in `~/.deepcode/settings.json` to the full path of the script. For detailed steps, refer to: https://binfer.net/share/jby5xnc-so6g
+Write a shell notification script that calls a Slack webhook, then set the `notify` field in `~/.deepcode/settings.json` to the full path of the script. For detailed steps, see [docs/notify_en.md](docs/notify_en.md).
 
 ### How do I enable web search?
 
diff --git a/README-zh_CN.md b/README-zh_CN.md
index 98346b6..8a427de 100644
--- a/README-zh_CN.md
+++ b/README-zh_CN.md
@@ -99,7 +99,7 @@ Deep Code 支持多模态，可使用ctrl+v从剪贴板粘贴图片。但目前
 
 ### 怎样在任务完成后自动给 Slack 发消息？
 
-编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 `~/.deepcode/settings.json` 中将 `notify` 字段设为该脚本的完整路径即可。详细步骤可参考：https://binfer.net/share/jby5xnc-so6g
+编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 `~/.deepcode/settings.json` 中将 `notify` 字段设为该脚本的完整路径即可。详细步骤请参考 [docs/notify.md](docs/notify.md)。
 
 ### 怎样启用联网搜索功能？
 
diff --git a/README.md b/README.md
index 98346b6..8a427de 100644
--- a/README.md
+++ b/README.md
@@ -99,7 +99,7 @@ Deep Code 支持多模态，可使用ctrl+v从剪贴板粘贴图片。但目前
 
 ### 怎样在任务完成后自动给 Slack 发消息？
 
-编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 `~/.deepcode/settings.json` 中将 `notify` 字段设为该脚本的完整路径即可。详细步骤可参考：https://binfer.net/share/jby5xnc-so6g
+编写一个调用 Slack webhook 的 Shell 通知脚本，然后在 `~/.deepcode/settings.json` 中将 `notify` 字段设为该脚本的完整路径即可。详细步骤请参考 [docs/notify.md](docs/notify.md)。
 
 ### 怎样启用联网搜索功能？
 
diff --git a/docs/configuration.md b/docs/configuration.md
index f8e52c3..1cce9a1 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -67,12 +67,24 @@ Deep Code 使用 `settings.json` 设置文件进行持久化配置，支持两
 
 设置一个 Shell 脚本的完整路径。当 AI 助手完成一轮任务后，会自动执行该脚本，可用于发送通知（如 Slack 消息）。
 
+通知脚本执行时，会通过环境变量注入以下上下文信息：
+
+| 环境变量 | 说明 |
+|----------|------|
+| `DURATION` | 会话耗时，单位秒（整数） |
+| `STATUS` | 会话状态：`"completed"` 或 `"failed"` |
+| `FAIL_REASON` | 失败原因（仅失败时设置） |
+| `BODY` | 最后一条 AI 助手回复的文本内容 |
+| `TITLE` | 会话标题（对应 resume 列表中的标题） |
+
 ```json
 {
-  "notify": "/path/to/slack-notify.sh"
+  "notify": "/path/to/notify-script.sh"
 }
 ```
 
+> 详细的 Slack、飞书、终端通知、系统通知等配置示例，请参阅 [notify.md](notify.md)。
+
 #### `webSearchTool` — 自定义联网搜索
 
 Deep Code 内置免费可用的 Web Search 工具。如果需要自定义搜索逻辑，可将 `webSearchTool` 设为一个可执行脚本的完整路径：
diff --git a/docs/configuration_en.md b/docs/configuration_en.md
index 369f8e4..fa396f9 100644
--- a/docs/configuration_en.md
+++ b/docs/configuration_en.md
@@ -67,12 +67,24 @@ When thinking mode is enabled, controls the depth of the model’s reasoning:
 
 Set a full path to a shell script. When the AI assistant finishes a round of tasks, the script is executed automatically, which can be used to send notifications (e.g., a Slack message).
 
+The following context is injected as environment variables when the notify script runs:
+
+| Variable | Description |
+|----------|-------------|
+| `DURATION` | Session duration in seconds (integer) |
+| `STATUS` | Session status: `"completed"` or `"failed"` |
+| `FAIL_REASON` | Failure reason (only set on failure) |
+| `BODY` | The text content of the last AI assistant reply |
+| `TITLE` | Session title (matches the resume list title) |
+
 ```json
 {
-  "notify": "/path/to/slack-notify.sh"
+  "notify": "/path/to/notify-script.sh"
 }
 ```
 
+> For detailed configuration examples (Slack, Feishu, terminal notifications, system notifications, etc.), see [notify_en.md](notify_en.md).
+
 #### `webSearchTool` — Custom Web Search
 
 Deep Code has a built-in, free-to-use Web Search tool. If you need custom search logic, set `webSearchTool` to the full path of an executable script:
diff --git a/docs/notify.md b/docs/notify.md
new file mode 100644
index 0000000..d73eef4
--- /dev/null
+++ b/docs/notify.md
@@ -0,0 +1,211 @@
+# Deep Code 任务完成通知
+
+当 AI 助手完成一轮任务后，Deep Code 可以自动执行一个通知脚本，将任务结果发送到你指定的渠道（如 Slack、系统通知等）。
+
+## 工作原理
+
+在 `settings.json` 中配置 `notify` 字段，指向一个可执行脚本的完整路径。每次 AI 助手完成任务应答后，Deep Code 会执行该脚本，并通过环境变量注入上下文信息。
+
+## 注入的环境变量
+
+| 环境变量 | 说明 |
+|----------|------|
+| `DURATION` | 会话耗时，单位秒（整数） |
+| `STATUS` | 会话状态：`"completed"` 或 `"failed"` |
+| `FAIL_REASON` | 失败原因（仅失败时设置） |
+| `BODY` | 最后一条 AI 助手回复的文本内容 |
+| `TITLE` | 会话标题（对应 resume 列表中的标题） |
+
+## 配置方法
+
+编辑 `~/.deepcode/settings.json`，添加 `notify` 字段：
+
+```json
+{
+  "env": {
+    "MODEL": "deepseek-v4-pro",
+    "BASE_URL": "https://api.deepseek.com",
+    "API_KEY": "sk-..."
+  },
+  "thinkingEnabled": true,
+  "reasoningEffort": "max",
+  "notify": "/path/to/your-notify-script.sh"
+}
+```
+
+你也可以在 `env` 中配置通知脚本所需的自定义环境变量，例如 Slack Webhook URL：
+
+```json
+{
+  "env": {
+    "MODEL": "deepseek-v4-pro",
+    "BASE_URL": "https://api.deepseek.com",
+    "API_KEY": "sk-...",
+    "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/*****/****/**********"
+  },
+  "notify": "/Users/you/.deepcode/notify-slack.sh"
+}
+```
+
+这些 `env` 中的变量会被注入到脚本的执行环境中。
+
+## Slack 通知
+
+### 1. 获取 Slack Webhook URL
+
+1. 创建 [Slack App](https://api.slack.com/apps)
+2. 在 App 页面点击 **Incoming Webhooks** → **Add New Webhook to Workspace**，生成 Webhook URL
+
+### 2. 创建通知脚本
+
+创建 `~/.deepcode/notify-slack.sh`：
+
+```bash
+#!/usr/bin/env bash
+SLACK_WEBHOOK_URL="${SLACK_WEBHOOK_URL:-}"
+CURRENT_DIR=$(pwd)
+BRANCH=$(git branch --show-current 2>/dev/null)
+curl -X POST "$SLACK_WEBHOOK_URL" \
+  -H "Content-type: application/json" \
+  --data "{
+      \"text\": \"✅ Deep Code 任务已完成\n · cwd: $CURRENT_DIR\n · Branch: $BRANCH\n · Duration: $DURATION 秒\"
+  }"
+```
+
+给脚本添加可执行权限：
+
+```bash
+chmod +x ~/.deepcode/notify-slack.sh
+```
+
+### 3. 配置 settings.json
+
+```json
+{
+  "env": {
+    "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/*****/****/**********"
+  },
+  "notify": "/Users/you/.deepcode/notify-slack.sh"
+}
+```
+
+> Python 版本的脚本同样支持，你可以在 `env` 中传入并引用任意自定义环境变量。
+
+## 飞书 / 企业微信等 Webhook 通知
+
+以下示例使用 `node` 构建 JSON（自动转义特殊字符），`curl` 发送。通过 `env` 传入 `WEBHOOK_URL`：
+
+```bash
+#!/bin/bash
+WEBHOOK_URL="${WEBHOOK_URL:-}"
+
+STATUS="${STATUS:-completed}"
+TITLE="${TITLE:-Untitled}"
+DURATION="${DURATION:-0}"
+BODY="${BODY:-(no output)}"
+
+PAYLOAD=$(node -e "
+process.stdout.write(JSON.stringify({
+  msg_type: 'interactive',
+  card: {
+    header: { title: { tag: 'plain_text', content: 'DeepCode: ' + process.env.TITLE + ' ' + process.env.STATUS + ' [' + process.env.DURATION + 's]' } },
+    elements: [{ tag: 'markdown', content: (process.env.BODY || '').slice(0, 2000) || '(no output)' }]
+  }
+}))
+")
+
+curl -s -X POST "$WEBHOOK_URL" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD"
+```
+
+```json
+{
+  "env": {
+    "WEBHOOK_URL": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxx"
+  },
+  "notify": "/Users/you/.deepcode/notify-feishu.sh"
+}
+```
+
+将 `WEBHOOK_URL` 替换为你的飞书机器人 Webhook 地址。此模式同样适用于 Slack、企业微信等 webhook 类通知，只需修改 JSON payload 格式。
+
+## 终端通知（iTerm2 / Windows Terminal）
+
+如果你的终端是 iTerm2 或 Windows Terminal，可以直接通过 OSC 9 转义序列弹出终端原生通知，无需额外依赖。
+
+创建 `~/.deepcode/notify.sh`：
+
+```bash
+#!/bin/bash
+# iTerm2 / Windows Terminal OSC 9 通知
+printf '\x1b]9;DeepCode: task %s (%ss)\x07' "${STATUS:-completed}" "${DURATION}"
+```
+
+```json
+{
+  "notify": "/Users/you/.deepcode/notify.sh"
+}
+```
+
+Windows 用户如使用 Git Bash，上述脚本同样可用；也可创建 `.bat` 脚本：
+
+```batch
+@echo off
+REM Windows Terminal OSC 9 通知
+echo \x1b]9;DeepCode: task %STATUS% (%DURATION%s)\x07
+```
+
+## macOS 系统通知
+
+```bash
+#!/bin/bash
+# macOS 系统通知
+osascript -e "display notification \"任务已${STATUS:-完成}，耗时 ${DURATION}s\" with title \"DeepCode\""
+```
+
+```json
+{
+  "notify": "/Users/you/.deepcode/notify.sh"
+}
+```
+
+## Linux 系统通知
+
+需要安装 `libnotify-bin`：
+
+```bash
+sudo apt install libnotify-bin   # Debian/Ubuntu
+```
+
+创建 `~/.deepcode/notify.sh`：
+
+```bash
+#!/bin/bash
+# Linux notify-send 通知
+notify-send "DeepCode" "任务已${STATUS:-完成}，耗时 ${DURATION}s"
+```
+
+```json
+{
+  "notify": "/home/you/.deepcode/notify.sh"
+}
+```
+
+## Windows msg 弹窗通知
+
+```batch
+@echo off
+REM Windows msg 弹窗通知
+msg %USERNAME% "DeepCode: task %STATUS% (%DURATION%s)"
+```
+
+```json
+{
+  "notify": "C:\\Users\\you\\.deepcode\\notify.bat"
+}
+```
+
+## 自定义通知脚本
+
+你可以根据通知脚本注入的环境变量自行编写任意逻辑的通知脚本（Python、Node.js、Ruby 等均可），只要脚本可执行即可。脚本中可通过 `env` 字段传入额外需要的配置变量。
diff --git a/docs/notify_en.md b/docs/notify_en.md
new file mode 100644
index 0000000..b949161
--- /dev/null
+++ b/docs/notify_en.md
@@ -0,0 +1,211 @@
+# Deep Code Task Completion Notification
+
+When the AI assistant finishes a round of tasks, Deep Code can automatically execute a notification script to send task results to your chosen channel (Slack, system notifications, etc.).
+
+## How It Works
+
+Configure the `notify` field in `settings.json` with the full path to an executable script. Every time the AI assistant completes a task response, Deep Code executes that script and injects context as environment variables.
+
+## Injected Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DURATION` | Session duration in seconds (integer) |
+| `STATUS` | Session status: `"completed"` or `"failed"` |
+| `FAIL_REASON` | Failure reason (only set on failure) |
+| `BODY` | The text content of the last AI assistant reply |
+| `TITLE` | Session title (matches the resume list title) |
+
+## Configuration
+
+Edit `~/.deepcode/settings.json` and add the `notify` field:
+
+```json
+{
+  "env": {
+    "MODEL": "deepseek-v4-pro",
+    "BASE_URL": "https://api.deepseek.com",
+    "API_KEY": "sk-..."
+  },
+  "thinkingEnabled": true,
+  "reasoningEffort": "max",
+  "notify": "/path/to/your-notify-script.sh"
+}
+```
+
+You can also configure custom environment variables for the notify script in `env`, such as a Slack Webhook URL:
+
+```json
+{
+  "env": {
+    "MODEL": "deepseek-v4-pro",
+    "BASE_URL": "https://api.deepseek.com",
+    "API_KEY": "sk-...",
+    "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/*****/****/**********"
+  },
+  "notify": "/Users/you/.deepcode/notify-slack.sh"
+}
+```
+
+These `env` variables are injected into the script's execution environment.
+
+## Slack Notification
+
+### 1. Get a Slack Webhook URL
+
+1. Create a [Slack App](https://api.slack.com/apps)
+2. In the App page, go to **Incoming Webhooks** → **Add New Webhook to Workspace** to generate a Webhook URL
+
+### 2. Create the Notification Script
+
+Create `~/.deepcode/notify-slack.sh`:
+
+```bash
+#!/usr/bin/env bash
+SLACK_WEBHOOK_URL="${SLACK_WEBHOOK_URL:-}"
+CURRENT_DIR=$(pwd)
+BRANCH=$(git branch --show-current 2>/dev/null)
+curl -X POST "$SLACK_WEBHOOK_URL" \
+  -H "Content-type: application/json" \
+  --data "{
+      \"text\": \"✅ Deep Code task completed\n · cwd: $CURRENT_DIR\n · Branch: $BRANCH\n · Duration: $DURATION s\"
+  }"
+```
+
+Make the script executable:
+
+```bash
+chmod +x ~/.deepcode/notify-slack.sh
+```
+
+### 3. Configure settings.json
+
+```json
+{
+  "env": {
+    "SLACK_WEBHOOK_URL": "https://hooks.slack.com/services/*****/****/**********"
+  },
+  "notify": "/Users/you/.deepcode/notify-slack.sh"
+}
+```
+
+> A Python version is also supported; you can pass and reference any custom environment variables via `env`.
+
+## Feishu / WeCom Webhook Notification
+
+Use `node` to build JSON (auto-escapes special characters) and `curl` to send. Pass `WEBHOOK_URL` via `env`:
+
+```bash
+#!/bin/bash
+WEBHOOK_URL="${WEBHOOK_URL:-}"
+
+STATUS="${STATUS:-completed}"
+TITLE="${TITLE:-Untitled}"
+DURATION="${DURATION:-0}"
+BODY="${BODY:-(no output)}"
+
+PAYLOAD=$(node -e "
+process.stdout.write(JSON.stringify({
+  msg_type: 'interactive',
+  card: {
+    header: { title: { tag: 'plain_text', content: 'DeepCode: ' + process.env.TITLE + ' ' + process.env.STATUS + ' [' + process.env.DURATION + 's]' } },
+    elements: [{ tag: 'markdown', content: (process.env.BODY || '').slice(0, 2000) || '(no output)' }]
+  }
+}))
+")
+
+curl -s -X POST "$WEBHOOK_URL" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD"
+```
+
+```json
+{
+  "env": {
+    "WEBHOOK_URL": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxx"
+  },
+  "notify": "/Users/you/.deepcode/notify-feishu.sh"
+}
+```
+
+Replace `WEBHOOK_URL` with your Feishu bot webhook URL. This pattern also works for other webhook-based notifications (Slack, WeCom, etc.) — just adjust the JSON payload format.
+
+## Terminal Notification (iTerm2 / Windows Terminal)
+
+On iTerm2 or Windows Terminal, you can use the OSC 9 escape sequence for native terminal notifications with zero dependencies.
+
+Create `~/.deepcode/notify.sh`:
+
+```bash
+#!/bin/bash
+# iTerm2 / Windows Terminal OSC 9 notification
+printf '\x1b]9;DeepCode: task %s (%ss)\x07' "${STATUS:-completed}" "${DURATION}"
+```
+
+```json
+{
+  "notify": "/Users/you/.deepcode/notify.sh"
+}
+```
+
+Windows users on Git Bash can use the same script; alternatively, create a `.bat` script:
+
+```batch
+@echo off
+REM Windows Terminal OSC 9 notification
+echo \x1b]9;DeepCode: task %STATUS% (%DURATION%s)\x07
+```
+
+## macOS System Notification
+
+```bash
+#!/bin/bash
+# macOS system notification
+osascript -e "display notification \"Task ${STATUS:-completed}, took ${DURATION}s\" with title \"DeepCode\""
+```
+
+```json
+{
+  "notify": "/Users/you/.deepcode/notify.sh"
+}
+```
+
+## Linux System Notification
+
+Requires `libnotify-bin`:
+
+```bash
+sudo apt install libnotify-bin   # Debian/Ubuntu
+```
+
+Create `~/.deepcode/notify.sh`:
+
+```bash
+#!/bin/bash
+# Linux notify-send notification
+notify-send "DeepCode" "Task ${STATUS:-completed}, took ${DURATION}s"
+```
+
+```json
+{
+  "notify": "/home/you/.deepcode/notify.sh"
+}
+```
+
+## Windows msg Popup Notification
+
+```batch
+@echo off
+REM Windows msg popup notification
+msg %USERNAME% "DeepCode: task %STATUS% (%DURATION%s)"
+```
+
+```json
+{
+  "notify": "C:\\Users\\you\\.deepcode\\notify.bat"
+}
+```
+
+## Custom Notification Scripts
+
+You can write your own notification scripts in any language (Python, Node.js, Ruby, etc.) using the injected environment variables and any additional variables passed via `env`.
diff --git a/src/common/notify.ts b/src/common/notify.ts
index 8878c50..d1b541b 100644
--- a/src/common/notify.ts
+++ b/src/common/notify.ts
@@ -16,11 +16,40 @@ export function formatDurationSeconds(durationMs: number): string {
   return String(Math.floor(safeMs / 1000));
 }
 
-export function buildNotifyEnv(durationMs: number, baseEnv: NodeJS.ProcessEnv = process.env): NodeJS.ProcessEnv {
-  return {
+export type NotifyContext = {
+  status?: string;
+  failReason?: string;
+  body?: string;
+  title?: string;
+};
+
+export function buildNotifyEnv(
+  durationMs: number,
+  baseEnv: NodeJS.ProcessEnv = process.env,
+  context: NotifyContext = {}
+): NodeJS.ProcessEnv {
+  const env: NodeJS.ProcessEnv = {
     ...baseEnv,
     DURATION: formatDurationSeconds(durationMs),
   };
+  delete env.STATUS;
+  delete env.FAIL_REASON;
+  delete env.BODY;
+  delete env.TITLE;
+
+  if (context.status) {
+    env.STATUS = context.status;
+  }
+  if (context.failReason) {
+    env.FAIL_REASON = context.failReason;
+  }
+  if (context.body) {
+    env.BODY = context.body;
+  }
+  if (context.title) {
+    env.TITLE = context.title;
+  }
+  return env;
 }
 
 export function launchNotifyScript(
@@ -28,7 +57,8 @@ export function launchNotifyScript(
   durationMs: number,
   workingDirectory?: string,
   spawnProcess: NotifySpawn = spawn as unknown as NotifySpawn,
-  configuredEnv: Record<string, string> = {}
+  configuredEnv: Record<string, string> = {},
+  context: NotifyContext = {}
 ): void {
   const commandPath = notifyPath?.trim();
   if (!commandPath) {
@@ -38,7 +68,7 @@ export function launchNotifyScript(
   const options = {
     cwd: workingDirectory,
     detached: process.platform !== "win32",
-    env: buildNotifyEnv(durationMs, { ...process.env, ...configuredEnv }),
+    env: buildNotifyEnv(durationMs, { ...process.env, ...configuredEnv }, context),
     stdio: "ignore" as const,
   };
 
diff --git a/src/session.ts b/src/session.ts
index 3b6b67a..4114746 100644
--- a/src/session.ts
+++ b/src/session.ts
@@ -2119,7 +2119,23 @@ ${skillMd}
       return;
     }
 
-    launchNotifyScript(notifyCommand, Date.now() - startedAt, this.projectRoot, undefined, configuredEnv);
+    // Find the last assistant message body for the BODY env variable.
+    let body: string | undefined;
+    const messages = this.listSessionMessages(sessionId);
+    for (let i = messages.length - 1; i >= 0; i--) {
+      const msg = messages[i];
+      if (msg && msg.role === "assistant" && msg.content) {
+        body = msg.content;
+        break;
+      }
+    }
+
+    launchNotifyScript(notifyCommand, Date.now() - startedAt, this.projectRoot, undefined, configuredEnv, {
+      status: session.status,
+      failReason: session.failReason ?? undefined,
+      body,
+      title: session.summary ?? undefined,
+    });
   }
 
   private addSessionProcess(sessionId: string, processId: string | number, command: string): void {
diff --git a/src/tests/session.test.ts b/src/tests/session.test.ts
index b7eadae..d079949 100644
--- a/src/tests/session.test.ts
+++ b/src/tests/session.test.ts
@@ -783,6 +783,68 @@ test("reporting a new prompt does not warn when the background request fails", a
   assert.deepEqual(warnings, []);
 });
 
+test(
+  "SessionManager notifies successful completion with session context",
+  { skip: process.platform === "win32" },
+  async () => {
+    const workspace = createTempDir("deepcode-notify-success-workspace-");
+    const home = createTempDir("deepcode-notify-success-home-");
+    setHomeDir(home);
+
+    const notifyOutput = path.join(workspace, "notify.jsonl");
+    const notifyScript = createNotifyRecorderScript(workspace);
+    const manager = createNotifyingSessionManager(
+      workspace,
+      [createChatResponse("final answer", { prompt_tokens: 1, completion_tokens: 1, total_tokens: 2 })],
+      notifyScript,
+      notifyOutput
+    );
+
+    await manager.createSession({ text: "notify success" });
+
+    const records = await waitForNotifyRecords(notifyOutput, 1);
+    assert.equal(records[0]?.STATUS, "completed");
+    assert.equal(records[0]?.FAIL_REASON, null);
+    assert.equal(records[0]?.BODY, "final answer");
+    assert.equal(records[0]?.TITLE, "notify success");
+    assert.match(String(records[0]?.DURATION), /^\d+$/);
+  }
+);
+
+test(
+  "SessionManager notifies failed completion with failure context",
+  { skip: process.platform === "win32" },
+  async () => {
+    const workspace = createTempDir("deepcode-notify-failure-workspace-");
+    const home = createTempDir("deepcode-notify-failure-home-");
+    setHomeDir(home);
+
+    const notifyOutput = path.join(workspace, "notify.jsonl");
+    const notifyScript = createNotifyRecorderScript(workspace);
+    const manager = createNotifyingSessionManager(
+      workspace,
+      [
+        createChatResponse("first answer", { prompt_tokens: 1, completion_tokens: 1, total_tokens: 2 }),
+        new Error("second request failed"),
+      ],
+      notifyScript,
+      notifyOutput
+    );
+
+    const sessionId = await manager.createSession({ text: "notify failure" });
+    await waitForNotifyRecords(notifyOutput, 1);
+    await manager.replySession(sessionId, { text: "second prompt" });
+
+    const records = await waitForNotifyRecords(notifyOutput, 2);
+    const failedRecord = records[1];
+    assert.equal(failedRecord?.STATUS, "failed");
+    assert.equal(failedRecord?.FAIL_REASON, "second request failed");
+    assert.equal(failedRecord?.BODY, "first answer");
+    assert.notEqual(failedRecord?.BODY, "stale-body");
+    assert.equal(failedRecord?.TITLE, "notify failure");
+  }
+);
+
 test("replySession continues without appending /continue as a user message", async () => {
   const workspace = createTempDir("deepcode-continue-workspace-");
   const home = createTempDir("deepcode-continue-home-");
@@ -1657,6 +1719,49 @@ function createSessionManager(projectRoot: string, machineId: string): SessionMa
   });
 }
 
+function createNotifyingSessionManager(
+  projectRoot: string,
+  responses: unknown[],
+  notifyPath: string,
+  notifyOutput: string
+): SessionManager {
+  const client = {
+    chat: {
+      completions: {
+        create: async () => {
+          const response = responses.shift();
+          assert.ok(response, "expected a queued chat response");
+          if (response instanceof Error) {
+            throw response;
+          }
+          return response;
+        },
+      },
+    },
+  };
+
+  return new SessionManager({
+    projectRoot,
+    createOpenAIClient: () => ({
+      client: client as any,
+      model: "test-model",
+      baseURL: "https://api.deepseek.com",
+      thinkingEnabled: false,
+      notify: notifyPath,
+      env: {
+        NOTIFY_OUTPUT: notifyOutput,
+        STATUS: "stale-status",
+        FAIL_REASON: "stale-failure",
+        BODY: "stale-body",
+        TITLE: "stale-title",
+      },
+    }),
+    getResolvedSettings: () => ({ model: "test-model" }),
+    renderMarkdown: (text) => text,
+    onAssistantMessage: () => {},
+  });
+}
+
 function createMockedClientSessionManager(projectRoot: string, responses: unknown[]): SessionManager {
   const client = {
     chat: {
@@ -1740,6 +1845,45 @@ function createTempDir(prefix: string): string {
   return dir;
 }
 
+function createNotifyRecorderScript(dir: string): string {
+  const scriptPath = path.join(dir, "notify-recorder.cjs");
+  fs.writeFileSync(
+    scriptPath,
+    `#!/usr/bin/env node
+const fs = require("fs");
+const keys = ["DURATION", "STATUS", "FAIL_REASON", "BODY", "TITLE"];
+const record = {};
+for (const key of keys) {
+  record[key] = Object.prototype.hasOwnProperty.call(process.env, key) ? process.env[key] : null;
+}
+fs.appendFileSync(process.env.NOTIFY_OUTPUT, JSON.stringify(record) + "\\n", "utf8");
+`,
+    "utf8"
+  );
+  fs.chmodSync(scriptPath, 0o755);
+  return scriptPath;
+}
+
+async function waitForNotifyRecords(
+  outputPath: string,
+  expectedCount: number
+): Promise<Array<Record<string, unknown>>> {
+  for (let attempt = 0; attempt < 100; attempt += 1) {
+    if (fs.existsSync(outputPath)) {
+      const records = fs
+        .readFileSync(outputPath, "utf8")
+        .split(/\r?\n/)
+        .filter(Boolean)
+        .map((line) => JSON.parse(line) as Record<string, unknown>);
+      if (records.length >= expectedCount) {
+        return records;
+      }
+    }
+    await new Promise((resolve) => setTimeout(resolve, 20));
+  }
+  assert.fail(`expected ${expectedCount} notify records in ${outputPath}`);
+}
+
 function escapeRegExp(value: string): string {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
diff --git a/src/tests/settings-and-notify.test.ts b/src/tests/settings-and-notify.test.ts
index 6990288..1707aff 100644
--- a/src/tests/settings-and-notify.test.ts
+++ b/src/tests/settings-and-notify.test.ts
@@ -1,6 +1,12 @@
 import { test } from "node:test";
 import assert from "node:assert/strict";
-import { buildNotifyEnv, formatDurationSeconds, launchNotifyScript, type NotifySpawn } from "../common/notify";
+import {
+  buildNotifyEnv,
+  formatDurationSeconds,
+  launchNotifyScript,
+  type NotifyContext,
+  type NotifySpawn,
+} from "../common/notify";
 import { applyModelConfigSelection, resolveSettings, resolveSettingsSources } from "../settings";
 
 const TEST_PROCESS_ENV = {};
@@ -358,14 +364,79 @@ test("formatDurationSeconds preserves sub-second precision and trims trailing ze
   assert.equal(formatDurationSeconds(4000), "4");
 });
 
-test("buildNotifyEnv injects DURATION", () => {
+test("buildNotifyEnv injects DURATION without context", () => {
   const env = buildNotifyEnv(2750, { HOME: "/tmp/home" });
   assert.equal(env.HOME, "/tmp/home");
   assert.equal(env.DURATION, "2");
+  assert.equal(env.STATUS, undefined);
+  assert.equal(env.FAIL_REASON, undefined);
+  assert.equal(env.BODY, undefined);
+  assert.equal(env.TITLE, undefined);
+});
+
+test("buildNotifyEnv injects STATUS, FAIL_REASON, BODY, and TITLE from context", () => {
+  const context: NotifyContext = {
+    status: "failed",
+    failReason: "API key not found",
+    body: "Hello, this is the last assistant message.",
+    title: "Fix login bug",
+  };
+  const env = buildNotifyEnv(5000, { HOME: "/tmp/home" }, context);
+  assert.equal(env.HOME, "/tmp/home");
+  assert.equal(env.DURATION, "5");
+  assert.equal(env.STATUS, "failed");
+  assert.equal(env.FAIL_REASON, "API key not found");
+  assert.equal(env.BODY, "Hello, this is the last assistant message.");
+  assert.equal(env.TITLE, "Fix login bug");
+});
+
+test("buildNotifyEnv omits optional context fields when not provided", () => {
+  const env = buildNotifyEnv(
+    1000,
+    {
+      HOME: "/tmp/home",
+      STATUS: "stale-status",
+      FAIL_REASON: "stale-failure",
+      BODY: "stale-body",
+      TITLE: "stale-title",
+    },
+    { status: "completed" }
+  );
+  assert.equal(env.STATUS, "completed");
+  assert.equal(env.FAIL_REASON, undefined);
+  assert.equal(env.BODY, undefined);
+  assert.equal(env.TITLE, undefined);
+});
+
+test("buildNotifyEnv ignores empty strings in context", () => {
+  const env = buildNotifyEnv(
+    1000,
+    { HOME: "/tmp/home" },
+    {
+      status: "",
+      failReason: "",
+      body: "",
+      title: "",
+    }
+  );
+  assert.equal(env.STATUS, undefined);
+  assert.equal(env.FAIL_REASON, undefined);
+  assert.equal(env.BODY, undefined);
+  assert.equal(env.TITLE, undefined);
+});
+
+test("buildNotifyEnv preserves special characters in body and title", () => {
+  const context: NotifyContext = {
+    body: 'Line 1\nLine 2\tindented "quoted"',
+    title: "Fix: login & signup (urgent)",
+  };
+  const env = buildNotifyEnv(1000, {}, context);
+  assert.equal(env.BODY, 'Line 1\nLine 2\tindented "quoted"');
+  assert.equal(env.TITLE, "Fix: login & signup (urgent)");
 });
 
 test(
-  "launchNotifyScript passes DURATION and falls back to /bin/sh for non-executable scripts",
+  "launchNotifyScript passes DURATION, context vars, and falls back to /bin/sh for non-executable scripts",
   { skip: process.platform === "win32" },
   () => {
     const calls: Array<{
@@ -390,7 +461,13 @@ test(
       };
     };
 
-    launchNotifyScript("/tmp/notify.sh", 2750, "/tmp/project", spawnProcess, { WEBHOOK: "configured" });
+    const context: NotifyContext = {
+      status: "completed",
+      body: "Task finished successfully.",
+      title: "Fix login bug",
+    };
+
+    launchNotifyScript("/tmp/notify.sh", 2750, "/tmp/project", spawnProcess, { WEBHOOK: "configured" }, context);
 
     assert.equal(calls.length, 2);
     assert.equal(calls[0]?.command, "/tmp/notify.sh");
@@ -398,9 +475,16 @@ test(
     assert.equal(calls[0]?.options.cwd, "/tmp/project");
     assert.equal(calls[0]?.options.env?.DURATION, "2");
     assert.equal(calls[0]?.options.env?.WEBHOOK, "configured");
+    assert.equal(calls[0]?.options.env?.STATUS, "completed");
+    assert.equal(calls[0]?.options.env?.FAIL_REASON, undefined);
+    assert.equal(calls[0]?.options.env?.BODY, "Task finished successfully.");
+    assert.equal(calls[0]?.options.env?.TITLE, "Fix login bug");
     assert.equal(calls[1]?.command, "/bin/sh");
     assert.deepEqual(calls[1]?.args, ["/tmp/notify.sh"]);
     assert.equal(calls[1]?.options.cwd, "/tmp/project");
     assert.equal(calls[1]?.options.env?.DURATION, "2");
+    assert.equal(calls[1]?.options.env?.STATUS, "completed");
+    assert.equal(calls[1]?.options.env?.BODY, "Task finished successfully.");
+    assert.equal(calls[1]?.options.env?.TITLE, "Fix login bug");
   }
 );