Add /export session transcript command and refresh roadmap.

Implement a Claude Code-style /export flow for the current session and update the README to document both the export feature and the Open Codex-specific update notification improvements.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: sa-buc

README.md

@@ -82,6 +82,26 @@ Four new subsystems inspired by Claude Code and oh-my-codex:
 
 This directly addresses roadmap item 3 (better memory mechanics).
 
+### 4. Open Codex-aware update detection and upgrade prompts
+
+From commit `e1e88af89d`:
+
+- switches npm/bun update detection from upstream Codex metadata to the fork package `@leonw24/open-codex`
+- updates upgrade commands and release notes links so prompts point to Open Codex instead of `@openai/codex`
+- keeps the runtime check aligned with the actual package users install from npm
+
+This is a fork-correctness patch: update notifications should describe the Open Codex release a user can actually install, not the upstream Codex CLI release stream.
+
+### 5. Session export inside the TUI
+
+From recent fork-specific changes:
+
+- adds `/export <path>` for the current session transcript
+- supports user-chosen filenames like `/export talk.md` or `/export talk.txt`
+- writes a markdown transcript suitable for debugging, archival, and sharing
+
+This brings a Claude Code-style export flow into the TUI without requiring external scripts or manual transcript scraping.
+
 ## Maintenance Philosophy
 
 This fork is maintained with a conservative strategy:
@@ -109,30 +129,26 @@ The near-term roadmap is intentionally focused on a few CLI-facing improvements:
 
 Improve the Codex CLI status line so it can surface token throughput directly, instead of only showing coarse task state. The aim is to make model responsiveness easier to judge in real time.
 
-### 2. Session export
+### 2. ~~Session export~~ ✅ Completed
 
-Implement a Claude Code-style export flow for the current session, so a user can export the active session record in a reusable format. The goal is to make debugging, sharing, and archival much easier.
+Implemented as a Claude Code-style `/export` flow for the current session, with user-defined filenames like `/export talk.txt` or `/export talk.md`. This now covers the debugging, sharing, and archival use case directly inside the TUI.
 
 ### 3. ~~Better memory mechanics~~ ✅ Completed
 
 Implemented as the consolidated memory subsystem (see Current Delta section 3 above). Remaining improvements tracked below.
 
-### 5. AutoDream background daemon
-
-Replace the startup-blocking Phase 2 consolidation with a 3-gate background consolidator (time ≥ 24h, ≥ 5 new sessions, no lock), using a 4-phase merge pipeline: Orient → Gather → Consolidate → Prune. Inspired by Claude Code's AutoDream.
-
-### 6. Notepad TUI sidebar
-
-Show notepad sections in the TUI sidebar so users can view and edit memory context without running `/memories` commands.
-
-### 7. Memory versioning
-
-Keep a lightweight changelog of topic edits so agents can reason about what changed and when.
-
 ### 4. Better Zellij ergonomics
 
 Continue improving the Codex CLI experience under `zellij`, especially around rendering, layout, contrast, and other interaction details that behave differently from plain terminal sessions or `tmux`.
 
+### Next focus areas
+
+- **Background AutoDream-style consolidation** — move consolidation fully off the startup path and replace it with a background 3-gate consolidator (time ≥ 24h, ≥ 5 new sessions, no lock), using a 4-phase pipeline: Orient → Gather → Consolidate → Prune.
+- **Notepad TUI sidebar** — surface notepad sections directly in the TUI sidebar so memory context can be viewed and edited without routing everything through `/memories`.
+- **Memory versioning** — keep a lightweight changelog for topic edits so agents can reason about what changed and when.
+- **More proactive subagent parallel planning** — let the agent split work and dispatch parallel subagents more aggressively instead of stepping through tasks strictly serially.
+- **Claude Code-style background execution** — automatically send long-running commands and agent work to the background rather than keeping the main process occupied by foreground waiting and polling.
+
 ## Community
 
 Issues and pull requests are welcome in this fork.
@@ -264,6 +280,26 @@ Codex CLI 是开源的，但上游仓库当前对外部代码贡献采用 invita
 
 直接完成了路线图第 3 项（更好的 memory 机制）。
 
+### 4. 面向 Open Codex 的版本检测与升级提示
+
+来自 commit `e1e88af89d`：
+
+- 把 npm/bun 更新检测从 upstream Codex 元数据切换到 fork 的 `@leonw24/open-codex`
+- 更新升级命令与 release notes 链接，使提示指向 Open Codex，而不是 `@openai/codex`
+- 让运行时版本提醒与用户实际通过 npm 安装的包保持一致
+
+这是一个 fork 正确性修复：版本提醒应该描述用户真正能安装的 Open Codex 版本，而不是 upstream Codex CLI 的发布流。
+
+### 5. TUI 内建 session 导出
+
+来自最近几条 fork 自有改动：
+
+- 为当前 session 增加 `/export <path>`
+- 支持用户自定义文件名，例如 `/export talk.md` 或 `/export talk.txt`
+- 导出 markdown transcript，便于调试、归档和分享
+
+这让类似 Claude Code 的会话导出能力直接进入 TUI，而不需要额外脚本或手工抓 transcript。
+
 ## 维护思路
 
 这个 fork 的维护策略是偏保守的：
@@ -291,30 +327,26 @@ Codex CLI 是开源的，但上游仓库当前对外部代码贡献采用 invita
 
 改进 Codex CLI 的 status line，让它可以直接展示 token 吞吐，而不只是显示比较粗粒度的任务状态，便于更直观判断模型响应效率。
 
-### 2. Session export
+### 2. ~~Session export~~ ✅ 已完成
 
-实现类似 Claude Code 的 session 导出能力，让用户可以把当前会话记录导出成可复用格式，方便调试、归档和分享。
+已实现类似 Claude Code 的 `/export` 会话导出能力，支持用户自定义文件名，例如 `/export talk.txt` 或 `/export talk.md`。当前已经覆盖调试、归档、分享这一类核心使用场景。
 
 ### 3. ~~更好的 memory 机制~~ ✅ 已完成
 
 已实现为合并 memory 子系统（见上方当前差异第 3 项）。后续改进见下方。
 
-### 5. AutoDream 后台守护进程
-
-用 3-gate 后台合并器（时间 ≥ 24h、≥ 5 个新 session、无锁）替代启动时阻塞的 Phase 2 合并，使用 4 阶段合并管线：Orient → Gather → Consolidate → Prune。借鉴 Claude Code 的 AutoDream。
-
-### 6. Notepad TUI 侧边栏
-
-在 TUI 侧边栏展示 notepad 分区，让用户无需运行 `/memories` 命令即可查看和编辑 memory 上下文。
-
-### 7. Memory 版本管理
-
-为 topic 编辑维护轻量级变更日志，让 agent 能推理内容何时发生了什么变化。
-
 ### 4. 更好的 Zellij 使用体验
 
 继续针对 `zellij` 下的 Codex CLI 使用体验做优化，包括渲染、布局、对比度，以及其他与普通 terminal 或 `tmux` 表现不同的交互细节。
 
+### 下一阶段重点
+
+- **后台化的 AutoDream 式 consolidation** — 把 consolidation 完整移出启动路径，改为后台 3-gate 合并器（时间 ≥ 24h、≥ 5 个新 session、无锁），并使用 4 阶段管线：Orient → Gather → Consolidate → Prune。
+- **Notepad TUI 侧边栏** — 直接在 TUI 侧边栏展示 notepad 分区，让用户无需总是通过 `/memories` 查看和编辑 memory 上下文。
+- **Memory 版本管理** — 为 topic 编辑维护轻量级变更日志，让 agent 能推理内容何时发生了什么变化。
+- **更主动的 subagent 并行规划** — 让 agent 能更积极地拆分任务并并行派发 subagent，而不是严格串行地一步步推进。
+- **Claude Code 风格的后台执行** — 自动把长时间运行的命令和 agent 工作放到后台，而不是长时间占用主进程做前台等待或轮询。
+
 ## 社区协作
 
 这个 fork 欢迎 issue 和 pull request。

codex-rs/tui/src/app.rs

@@ -572,6 +572,13 @@ pub(crate) struct App {
     pending_plugin_enabled_writes: HashMap<String, Option<bool>>,
 }
 
+fn line_to_string(line: &Line<'static>) -> String {
+    line.spans
+        .iter()
+        .map(|span| span.content.as_ref())
+        .collect::<String>()
+}
+
 fn active_turn_not_steerable_turn_error(error: &TypedRequestError) -> Option<AppServerTurnError> {
     let TypedRequestError::Server { source, .. } = error else {
         return None;
@@ -1169,6 +1176,39 @@ impl App {
     }
 }
 
+impl App {
+    pub(crate) fn export_transcript_markdown(&self) -> String {
+        const EXPORT_WIDTH: u16 = 240;
+
+        let mut lines: Vec<String> = Vec::new();
+        let mut first = true;
+        for cell in &self.transcript_cells {
+            let transcript_lines = cell.transcript_lines(EXPORT_WIDTH);
+            if transcript_lines.is_empty() {
+                continue;
+            }
+            if !cell.is_stream_continuation() && !first {
+                lines.push(String::new());
+            }
+            lines.extend(transcript_lines.iter().map(line_to_string));
+            first = false;
+        }
+
+        if let Some(active_lines) = self.chat_widget.active_cell_transcript_lines(EXPORT_WIDTH) {
+            if !lines.is_empty() {
+                lines.push(String::new());
+            }
+            lines.extend(active_lines.iter().map(line_to_string));
+        }
+
+        let mut transcript = lines.join("\n");
+        if !transcript.ends_with('\n') {
+            transcript.push('\n');
+        }
+        transcript
+    }
+}
+
 impl Drop for App {
     fn drop(&mut self) {
         if let Err(err) = self.chat_widget.clear_managed_terminal_title() {

codex-rs/tui/src/app/event_dispatch.rs

@@ -343,6 +343,35 @@ impl App {
                 ));
                 tui.frame_requester().schedule_frame();
             }
+            AppEvent::ExportTranscript { path } => {
+                let transcript = self.export_transcript_markdown();
+                let tx = self.app_event_tx.clone();
+                tokio::spawn(async move {
+                    if let Some(parent) = path.parent()
+                        && let Err(err) = tokio::fs::create_dir_all(parent).await
+                    {
+                        let _ = tx.send(AppEvent::MemoryCommandResult {
+                            text: format!("Failed to create export directory: {}", err),
+                            is_error: true,
+                        });
+                        return;
+                    }
+                    match tokio::fs::write(&path, transcript).await {
+                        Ok(()) => {
+                            let _ = tx.send(AppEvent::MemoryCommandResult {
+                                text: format!("Exported session to {}.", path.display()),
+                                is_error: false,
+                            });
+                        }
+                        Err(err) => {
+                            let _ = tx.send(AppEvent::MemoryCommandResult {
+                                text: format!("Failed to export session: {}", err),
+                                is_error: true,
+                            });
+                        }
+                    }
+                });
+            }
             AppEvent::OpenAppLink {
                 app_id,
                 title,

codex-rs/tui/src/app/tests.rs

@@ -104,6 +104,26 @@ fn test_absolute_path(path: &str) -> AbsolutePathBuf {
     AbsolutePathBuf::try_from(PathBuf::from(path)).expect("absolute test path")
 }
 
+#[tokio::test]
+async fn export_transcript_markdown_renders_committed_cells() {
+    let mut app = make_test_app().await;
+    app.transcript_cells = vec![
+        Arc::new(UserHistoryCell {
+            message: "hello".to_string(),
+            text_elements: Vec::new(),
+            local_image_paths: Vec::new(),
+            remote_image_urls: Vec::new(),
+        }),
+        Arc::new(PlainHistoryCell::new(vec![Line::from("world")])),
+    ];
+
+    let rendered = app.export_transcript_markdown();
+
+    assert!(rendered.contains("hello"));
+    assert!(rendered.contains("world"));
+    assert!(rendered.ends_with('\n'));
+}
+
 #[tokio::test]
 async fn handle_mcp_inventory_result_clears_committed_loading_cell() {
     let mut app = make_test_app().await;

codex-rs/tui/src/app_event.rs

@@ -248,6 +248,11 @@ pub(crate) enum AppEvent {
     /// Result of computing a `/diff` command.
     DiffResult(String),
 
+    /// Export the current session transcript to the provided path.
+    ExportTranscript {
+        path: PathBuf,
+    },
+
     /// Open the app link view in the bottom pane.
     OpenAppLink {
         app_id: String,

codex-rs/tui/src/chatwidget/slash_dispatch.rs

@@ -31,6 +31,7 @@ const SIDE_REVIEW_UNAVAILABLE_MESSAGE: &str =
 const SIDE_SLASH_COMMAND_UNAVAILABLE_HINT: &str = "Press Esc to return to the main thread first.";
 const GOAL_USAGE: &str = "Usage: /goal <objective>";
 const GOAL_USAGE_HINT: &str = "Example: /goal improve benchmark coverage";
+const EXPORT_USAGE: &str = "Usage: /export <path>";
 
 impl ChatWidget {
     /// Dispatch a bare slash command and record its staged local-history entry.
@@ -319,6 +320,9 @@ impl ChatWidget {
             SlashCommand::Copy => {
                 self.copy_last_agent_markdown();
             }
+            SlashCommand::Export => {
+                self.add_error_message(EXPORT_USAGE.to_string());
+            }
             SlashCommand::Diff => {
                 self.add_diff_in_progress();
                 let tx = self.app_event_tx.clone();
@@ -570,6 +574,11 @@ impl ChatWidget {
                 "verbose" => self.add_mcp_output(McpServerStatusDetail::Full),
                 _ => self.add_error_message("Usage: /mcp [verbose]".to_string()),
             },
+            SlashCommand::Export if !trimmed.is_empty() => {
+                self.app_event_tx.send(AppEvent::ExportTranscript {
+                    path: self.config.cwd.join(trimmed).to_path_buf(),
+                });
+            }
             SlashCommand::Rename if !trimmed.is_empty() => {
                 if !self.ensure_thread_rename_allowed() {
                     return;
@@ -1003,6 +1012,7 @@ impl ChatWidget {
             | SlashCommand::DebugConfig
             | SlashCommand::Ps
             | SlashCommand::Stop
+            | SlashCommand::Export
             | SlashCommand::MemoryDrop
             | SlashCommand::MemoryUpdate
             | SlashCommand::Mcp

codex-rs/tui/src/chatwidget/tests/slash_commands.rs

@@ -1303,6 +1303,41 @@ async fn slash_copy_state_tracks_plan_item_completion() {
     );
 }
 
+#[tokio::test]
+async fn slash_export_with_path_requests_transcript_export() {
+    let (mut chat, mut rx, mut op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
+    let tempdir = tempdir().unwrap();
+    chat.config.cwd = tempdir.path().to_path_buf().abs();
+
+    submit_composer_text(&mut chat, "/export talk.md");
+
+    assert_matches!(
+        rx.try_recv(),
+        Ok(AppEvent::ExportTranscript { path }) if path == tempdir.path().join("talk.md")
+    );
+    assert_matches!(op_rx.try_recv(), Err(TryRecvError::Empty));
+    assert_eq!(recall_latest_after_clearing(&mut chat), "/export talk.md");
+}
+
+#[tokio::test]
+async fn slash_export_without_path_shows_usage() {
+    let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;
+
+    submit_composer_text(&mut chat, "/export");
+
+    let cells = drain_insert_history(&mut rx);
+    let rendered = cells
+        .iter()
+        .map(|cell| lines_to_single_string(cell))
+        .collect::<Vec<_>>()
+        .join("\n");
+    assert!(
+        rendered.contains("Usage: /export <path>"),
+        "expected usage message, got: {rendered:?}"
+    );
+    assert_eq!(recall_latest_after_clearing(&mut chat), "/export");
+}
+
 #[tokio::test]
 async fn slash_copy_reports_when_no_agent_response_exists() {
     let (mut chat, mut rx, _op_rx) = make_chatwidget_manual(/*model_override*/ None).await;