feat: include cwd in notify payload (#5415)

Expose the session cwd in the notify payload and update docs so scripts
and extensions receive the real project path; users get accurate
project-aware notifications in CLI and VS Code.

Fixes #5387

Author: tibo-openai

codex-rs/core/src/codex.rs

@@ -1,5 +1,6 @@
 use std::borrow::Cow;
-use std::collections::{HashMap, HashSet};
+use std::collections::HashMap;
+use std::collections::HashSet;
 use std::fmt::Debug;
 use std::path::PathBuf;
 use std::sync::Arc;
@@ -23,6 +24,7 @@ use codex_protocol::items::TurnItem;
 use codex_protocol::items::UserMessageItem;
 use codex_protocol::protocol::ConversationPathResponseEvent;
 use codex_protocol::protocol::ExitedReviewModeEvent;
+#[cfg(test)]
 use codex_protocol::protocol::McpAuthStatus;
 use codex_protocol::protocol::MemoryPreviewEntry;
 use codex_protocol::protocol::MemoryPreviewEvent;
@@ -1893,6 +1895,7 @@ pub(crate) async fn run_task(
                         .notify(&UserNotification::AgentTurnComplete {
                             thread_id: sess.conversation_id.to_string(),
                             turn_id: sub_id.clone(),
+                            cwd: turn_context.cwd.display().to_string(),
                             input_messages: turn_input_messages,
                             last_assistant_message: last_agent_message.clone(),
                         });

codex-rs/core/src/user_notification.rs

@@ -51,6 +51,7 @@ pub(crate) enum UserNotification {
     AgentTurnComplete {
         thread_id: String,
         turn_id: String,
+        cwd: String,
 
         /// Messages that the user sent to the agent to initiate the turn.
         input_messages: Vec<String>,
@@ -70,6 +71,7 @@ mod tests {
         let notification = UserNotification::AgentTurnComplete {
             thread_id: "b5f6c1c2-1111-2222-3333-444455556666".to_string(),
             turn_id: "12345".to_string(),
+            cwd: "/Users/example/project".to_string(),
             input_messages: vec!["Rename `foo` to `bar` and update the callsites.".to_string()],
             last_assistant_message: Some(
                 "Rename complete and verified `cargo build` succeeds.".to_string(),
@@ -78,7 +80,7 @@ mod tests {
         let serialized = serde_json::to_string(&notification)?;
         assert_eq!(
             serialized,
-            r#"{"type":"agent-turn-complete","thread-id":"b5f6c1c2-1111-2222-3333-444455556666","turn-id":"12345","input-messages":["Rename `foo` to `bar` and update the callsites."],"last-assistant-message":"Rename complete and verified `cargo build` succeeds."}"#
+            r#"{"type":"agent-turn-complete","thread-id":"b5f6c1c2-1111-2222-3333-444455556666","turn-id":"12345","cwd":"/Users/example/project","input-messages":["Rename `foo` to `bar` and update the callsites."],"last-assistant-message":"Rename complete and verified `cargo build` succeeds."}"#
         );
         Ok(())
     }

codex-rs/tui/src/history_cell.rs

@@ -20,9 +20,9 @@ use crate::version::CODEX_CLI_VERSION;
 use crate::wrapping::RtOptions;
 use crate::wrapping::word_wrap_line;
 use crate::wrapping::word_wrap_lines;
-use codex_common::format_env_display::format_env_display;
 use base64::Engine;
 use codex_agentic_core::index::query::QueryHit;
+use codex_common::format_env_display::format_env_display;
 use codex_core::config::Config;
 use codex_core::config_types::McpServerTransportConfig;
 use codex_core::config_types::ReasoningSummaryFormat;
@@ -37,7 +37,9 @@ use codex_protocol::plan_tool::UpdatePlanArgs;
 use image::DynamicImage;
 use image::ImageReader;
 use mcp_types::EmbeddedResourceResource;
+use mcp_types::Resource;
 use mcp_types::ResourceLink;
+use mcp_types::ResourceTemplate;
 use ratatui::prelude::*;
 use ratatui::style::Modifier;
 use ratatui::style::Style;
@@ -46,8 +48,6 @@ use ratatui::style::Stylize;
 use ratatui::widgets::Paragraph;
 use ratatui::widgets::WidgetRef;
 use ratatui::widgets::Wrap;
-use mcp_types::Resource;
-use mcp_types::ResourceTemplate;
 use std::any::Any;
 use std::collections::HashMap;
 use std::io::Cursor;

codex-rs/tui/src/updates.rs

@@ -76,23 +76,26 @@ fn version_filepath(config: &Config) -> PathBuf {
 
 fn resolve_latest_url(update_config: &UpdateConfig) -> Option<String> {
     if let Some(url) = &update_config.latest_url
-        && !url.trim().is_empty() {
-            return Some(url.clone());
-        }
+        && !url.trim().is_empty()
+    {
+        return Some(url.clone());
+    }
     if let Some(repo) = &update_config.repo
-        && !repo.trim().is_empty() {
-            return Some(format!(
-                "https://api.github.com/repos/{repo}/releases/latest"
-            ));
-        }
+        && !repo.trim().is_empty()
+    {
+        return Some(format!(
+            "https://api.github.com/repos/{repo}/releases/latest"
+        ));
+    }
     Some(LATEST_RELEASE_URL.to_string())
 }
 
 fn release_url(update_config: &UpdateConfig) -> Option<String> {
     if let Some(repo) = &update_config.repo
-        && !repo.trim().is_empty() {
-            return Some(format!("https://github.com/{repo}/releases/latest"));
-        }
+        && !repo.trim().is_empty()
+    {
+        return Some(format!("https://github.com/{repo}/releases/latest"));
+    }
     update_config
         .latest_url
         .as_ref()

docs/config.md

@@ -626,6 +626,7 @@ Specify a program that will be executed to get notified about events generated b
   "type": "agent-turn-complete",
   "thread-id": "b5f6c1c2-1111-2222-3333-444455556666",
   "turn-id": "12345",
+  "cwd": "/Users/alice/projects/example",
   "input-messages": ["Rename `foo` to `bar` and update the callsites."],
   "last-assistant-message": "Rename complete and verified `cargo build` succeeds."
 }
@@ -635,6 +636,8 @@ The `"type"` property will always be set. Currently, `"agent-turn-complete"` is
 
 `"thread-id"` contains a string that identifies the Codex session that produced the notification; you can use it to correlate multiple turns that belong to the same task.
 
+`"cwd"` reports the absolute working directory for the session so scripts can disambiguate which project triggered the notification.
+
 As an example, here is a Python script that parses the JSON and decides whether to show a desktop push notification using [terminal-notifier](https://github.com/julienXX/terminal-notifier) on macOS:
 
 ```python