Repository navigation
Releases: chuangchuangtan/codexview
Release list
CodexView 6.3.0-dev.5 · Public Preview
CodexView 6.3.0-dev.5 · Task window repair / 连续翻阅修复
Released 2026-10-25 (Asia/Shanghai). Development preview. Previous release files remain available.
-
Prevent duplicate task mounting through one idempotent window commit.
-
Update selection during ordinary scrolling without restarting navigation or cancelling prose requests.
-
Restore measured task heights when replacing spacers; retain section measurements and paragraph anchors. Ignore stale prefetches and detached observers.
-
Retry superseded payload requests; retain Important/Marked, notes, search and report navigation.
-
修复同一任务重复挂载,统一窗口增删逻辑。
-
普通滚动仅更新选中任务,不重启导航或取消正文请求。
-
恢复旧任务时保留实测高度与段落位置,忽略过期预加载和已移除节点的观察回调。
-
修复取消请求后的重新加载,保留审阅、笔记、搜索和报告阅读。
Validation: 30 Python tests, seven frontend suites, and real-server task 830–834 forward/backward/changing-direction checks. The reader stays bounded to three task DOM nodes. Native discovery remains enabled; source data stays strictly read-only. No session/index migration is required. Measurements and scope are in performance notes.
验证包含实际大会话 830–834 前后及反复翻阅、不同高度、重复插入、迟到响应与阅读位置测试。正文保持最多三个任务节点,Native 发现开启,Codex 原始数据严格只读,无需重建索引。
Install / 安装
Download codexview-6.3.0-dev.5. Back up review state and stop the service before replacing the executable. Run in the download directory / 备份审阅记录并停止旧服务,在下载目录执行:
mkdir -p "$HOME/.local/bin"
cp codexview-6.3.0-dev.5 "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --version
codexview serve --host 0.0.0.0 --port 80 --file-root /path/to/projectRestart with the same options and refresh the browser; verify 6.3.0-dev.5. Container access uses the mapped host port. Local-only access: codexview serve.
用原参数启动并刷新浏览器,确认版本为 6.3.0-dev.5。容器从映射后的宿主机端口访问。
English README · 中文说明 · Limits · MIT
CodexView 6.3.0-dev.4 · Public Preview
CodexView 6.3.0-dev.4 · Review controls hotfix / 审阅操作修复
Released 2026-10-22 (Asia/Shanghai). Development preview; Linux/macOS, Python 3.7+, no third-party runtime dependencies. Previous release files remain available.
Fixed / 修复
-
Important, Marked, Later, Reviewed and note edits now reach the existing review-state API. The missing frontend save handler previously caused clicks to fail before sending a request.
-
Restore next/previous buttons, J/K and command-palette task navigation.
-
Update review controls, navigator badges and counts without reloading prose or moving the reading position. Serialize writes and disable duplicate pending toggles.
-
Failed saves show a message and retain unsaved note text; failed marks are not displayed as saved.
-
Add regressions covering actual clicks, keyboard actions, all review flags, notes, persistence, errors, filtering and source integrity.
-
恢复 Important、Marked、Later、Reviewed 和笔记保存:此前缺失前端保存函数,点击后未发出请求。
-
恢复上下任务按钮、J/K 与命令面板导航。
-
原位更新按钮、左侧标记及统计,保留正文和阅读位置;保存请求串行处理,避免重复点击。
-
保存失败明确提示,保留未保存笔记,不把失败标记显示为已保存。
-
补充实际点击、快捷键、全部标记、笔记、持久化、失败、筛选及源文件完整性测试。
Includes the continuous reader from 6.3.0-dev.3. Native discovery remains enabled. Codex-owned sessions, rollouts, config and auth stay strictly read-only; only CodexView review state is written. No index rebuild or transcript-format change is required.
保留 6.3.0-dev.3 连续阅读能力。Native 发现保持开启;Codex 原始 session、rollout、config、auth 严格只读,仅写入 CodexView 自己的审阅状态,无需重建索引或迁移会话。
Install / 安装
Download codexview-6.3.0-dev.4. Back up review state and stop an existing service before replacing the program. Run in the download directory / 先备份审阅记录并停止旧服务,在下载目录执行:
mkdir -p "$HOME/.local/bin"
cp codexview-6.3.0-dev.4 "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --version
codexview serve --host 0.0.0.0 --port 80 --file-root /path/to/projectExpected / 应显示:CodexView 6.3.0-dev.4. Restart with your previous options. Container access uses the mapped host port; refresh the browser to load the fixed controls.
使用原参数重新启动;容器从映射后的宿主机端口访问,浏览器刷新后加载修复。
CodexView 6.3.0-dev.3 · Public Preview
CodexView 6.3.0-dev.3 · Development Preview / 开发预览版
Released 2026-10-21 (Asia/Shanghai). Linux/macOS, Python 3.7+, no third-party runtime dependencies. Previous 6.2.1 and 6.3.0-dev.2 files and baseline tags remain available.
2026-10-21(北京时间)发布。保持单文件、轻量与严格只读,保留旧版发布包及基线。这是开发预览版。
Changes / 更新
-
Continuous task scrolling retains evicted heights and preloads adjacent prose; asynchronous loading no longer seeks back to the task start.
-
Sticky task context, visible-page new-content notifications and explicit Follow latest; manual reading pauses following.
-
Section chunks inside exceptional tasks retain deep search and reading recovery.
-
Optional compressed search cache: explicit build/update, cancellation, append support, bounded storage and streaming fallback; Chinese substrings preserved.
-
Report links from loaded tasks, local image zoom, HTML image navigation and explicit parent/fork session links.
-
连续翻阅保留移出任务的高度并预加载邻接正文,移除异步加载后的回跳。
-
顶部任务上下文、新增内容提示、主动跟随最新;手动阅读暂停跟随。
-
超长单任务分块,保留深层搜索定位和阅读恢复。
-
可选压缩搜索缓存,主动构建、追加更新、可取消,保留中文子串与流式回退。
-
已读任务报告入口、图片放大、HTML 图片导航及明确元数据支持的会话关系。
On a 755-task / approximately 616 MB real session, 100-sample warm endpoint p95 values remained below 23 ms on server loopback. Three unique cache queries improved from 5.6–6.8 s to 2.8–3.7 s with identical results; explicit initial preparation took about 11 s. These are workload-specific HTTP/query measurements, not first-paint guarantees. See performance scope.
Install / 安装
Download codexview-6.3.0-dev.3. Back up review state and stop an existing service before replacing the executable.
下载上述单文件程序,在下载目录执行。已有安装请先备份审阅记录并停止服务。
mkdir -p "$HOME/.local/bin"
cp codexview-6.3.0-dev.3 "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --version
codexview serve --host 0.0.0.0 --port 80 --file-root /path/to/projectExpected version / 应显示:CodexView 6.3.0-dev.3.
For local-only access, run codexview serve. For containers, use the mapped host port. --file-root is a project directory, such as the session's cwd; file reading is disabled without it.
本机访问可用 codexview serve;容器使用映射后的宿主机端口。--file-root 指向项目工作目录,未指定时文件阅读关闭。
Limits / 边界
Native discovery stays enabled. Codex-owned sessions, rollouts, config and auth are strictly read-only. Search cache preparation is optional and never runs on entry. Each cache is capped at 128 MiB, with two ready caches and at most one additional temporary build. Caches contain conversation text and require the same access protection as the viewer. Search returns at most 200 records. Reports and images retain configured roots and bounded reads. HTML scripts, forms and external resources remain blocked. Relationships without explicit metadata are not inferred. No built-in authentication or multi-user review isolation is provided.
Native 会话发现保持开启,Codex 原始数据严格只读。缓存需主动准备,每份最多 128 MiB,保留两份就绪缓存及最多一份临时构建。缓存含会话文本,应与阅读器采用相同访问保护。搜索最多 200 条,报告目录和体积限制不变,HTML 脚本与外部资源保持禁用,不猜测未声明的会话关系,不内置登录或多用户审阅隔离。
CodexView 6.3.0-dev.2 · Public Preview
CodexView 6.3.0-dev.2 · Development Preview / 开发预览版
Released 2026-10-21 (Asia/Shanghai). Linux and macOS; Python 3.7+ with no third-party runtime dependencies. This is a preview, not a stable-release promotion. The 6.2.1 baseline remains available.
2026-10-21(北京时间)发布。支持 Linux 与 macOS,需要 Python 3.7+,无需第三方运行依赖。这是开发预览版,保留 6.2.1 历史基线。
Changes / 更新内容
-
Resume the visible task and paragraph using bounded browser-local bookmarks; explicit task links take priority on navigation.
-
Local HTML report navigation keeps filename, Source and Refresh aligned with the current file, with a return link to the originating task.
-
Optional Markdown contents with Unicode and duplicate-heading anchors.
-
Compact task rows, reading-width presets and grouped review controls retain resizing and on-demand reading.
-
恢复任务与段落阅读位置,记录仅保存在当前浏览器;直接打开任务链接时优先定位该任务。
-
修正 HTML 报告导航,标题、源码与刷新对应当前文件,可返回原任务。
-
Markdown 分级目录,支持中文锚点与同名标题。
-
紧凑任务列表、正文宽度预设和审阅操作收纳,保留拖动调整与按需加载。
Includes the Markdown/static HTML reader from 6.3.0-dev. Native discovery stays enabled and Codex-owned records remain read-only. No third-party runtime dependencies were added.
包含 6.3.0-dev 的 Markdown 与静态 HTML 阅读能力。Native 发现保持开启,Codex 原始数据严格只读,无新增第三方运行依赖。
Install / 安装
Download codexview-6.3.0-dev.2, then run these commands in the download directory.
下载上述无扩展名单文件程序,在下载目录依次执行。已有安装请先停止服务并备份审阅记录。
mkdir -p "$HOME/.local/bin"
cp codexview-6.3.0-dev.2 "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --versionExpected / 应显示:CodexView 6.3.0-dev.2.
For a server or container / 服务器或容器部署:
codexview serve --host 0.0.0.0 --port 80 --file-root /path/to/project--file-root is the project working directory on the server, such as the session’s cwd, not the .codex/sessions storage directory. Repeat it for additional roots. File reading stays disabled without an explicit root. Use the mapped host port for container access.
--file-root 指向服务器上的项目工作目录,可与会话的 cwd 一致,不是 .codex/sessions 数据目录。可重复设置多个目录;未指定时文件阅读关闭。容器访问使用映射后的宿主机端口。
For local access / 本机访问:codexview serve, then open / 打开 http://127.0.0.1:17864/ .
Files and limits / 文件与边界
codexview-6.3.0-dev.2: standalone program / 单文件程序。- ZIP / tar.gz: matching source, documentation and tests / 对应版本的源码、文档与测试。
- Manifest / SHA256SUMS: source and download verification / 源码与下载校验。
HTML previews disable scripts, forms and external resources. Reports stay within configured roots and are read-only. There is no built-in login; use a trusted network or authenticated proxy. First search of a large session can take seconds; at most 200 matches are returned. Windows and all Codex CLI formats have not been validated.
HTML 预览禁用脚本、表单和外部资源,报告仅在配置目录内只读访问。不内置登录,远程访问请使用可信网络或认证代理。首次搜索大会话可能需要数秒,最多返回 200 条匹配。Windows 与全部 Codex CLI 格式尚未完成验证。
CodexView 6.3.0-dev · Public Preview
CodexView 6.3.0-dev · Development Preview / 开发预览版
Released 2026-10-21 (Asia/Shanghai). Linux and macOS; Python 3.7+ with no third-party runtime dependencies. This is a preview, not a stable-release promotion. The 6.2.1 baseline remains available.
2026-10-21(北京时间)发布。支持 Linux 与 macOS,需要 Python 3.7+,无需第三方运行依赖。这是开发预览版,保留 6.2.1 历史基线。
Changes / 更新内容
-
Open linked Markdown and static HTML reports in a separate reader, on demand.
-
Explicit read-only project roots, source view, manual refresh, and approved local images/CSS.
-
Native discovery stays enabled; no report scans in the session opening path.
-
按需阅读会话链接中的 Markdown 和静态 HTML 报告。
-
支持指定项目目录、查看源码、手动刷新、本地图片与 CSS。
-
Native 会话发现保持开启,报告读取不加入会话首屏索引。
This is the historical first document-reader preview. For reading recovery, report navigation fixes and Markdown contents, use 6.3.0-dev.2.
这是最初的文档阅读预览版本。阅读位置恢复、报告导航修正与 Markdown 目录请使用 6.3.0-dev.2。
Install / 安装
Download codexview-6.3.0-dev, then run these commands in the download directory.
下载上述无扩展名单文件程序,在下载目录依次执行。已有安装请先停止服务并备份审阅记录。
mkdir -p "$HOME/.local/bin"
cp codexview-6.3.0-dev "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --versionExpected / 应显示:CodexView 6.3.0-dev.
For a server or container / 服务器或容器部署:
codexview serve --host 0.0.0.0 --port 80 --file-root /path/to/project--file-root is the project working directory on the server, such as the session’s cwd, not the .codex/sessions storage directory. Repeat it for additional roots. File reading stays disabled without an explicit root. Use the mapped host port for container access.
--file-root 指向服务器上的项目工作目录,可与会话的 cwd 一致,不是 .codex/sessions 数据目录。可重复设置多个目录;未指定时文件阅读关闭。容器访问使用映射后的宿主机端口。
For local access / 本机访问:codexview serve, then open / 打开 http://127.0.0.1:17864/ .
Files and limits / 文件与边界
codexview-6.3.0-dev: standalone program / 单文件程序。- ZIP / tar.gz: matching source, documentation and tests / 对应版本的源码、文档与测试。
- Manifest / SHA256SUMS: source and download verification / 源码与下载校验。
HTML previews disable scripts, forms and external resources. Reports stay within configured roots and are read-only. There is no built-in login; use a trusted network or authenticated proxy. First search of a large session can take seconds; at most 200 matches are returned. Windows and all Codex CLI formats have not been validated.
HTML 预览禁用脚本、表单和外部资源,报告仅在配置目录内只读访问。不内置登录,远程访问请使用可信网络或认证代理。首次搜索大会话可能需要数秒,最多返回 200 条匹配。Windows 与全部 Codex CLI 格式尚未完成验证。
CodexView 6.2.1 · Public Preview
CodexView 6.2.1 · Public Preview / 公开预览版
A lightweight, read-only viewer for Codex CLI sessions. Single-file deployment on Linux and macOS; Python 3.7+ is required, with no third-party runtime dependencies.
轻量、只读的 Codex CLI 会话阅读器。支持 Linux 与 macOS,单文件部署,需要 Python 3.7+,无需第三方运行依赖。
Highlights / 主要功能
- Native session discovery stays enabled; Codex-owned data remains read-only.
- On-demand reading for large conversations, task navigation, timestamps and expandable tool evidence.
- Content search, task-title filtering, private review marks and notes.
- Compact task navigator, resizable reading layout, dark/light themes and mobile drawer.
Native 会话发现始终开启;大会话按需加载,支持任务时间、正文搜索、执行记录、独立审阅笔记、紧凑侧栏、明暗主题与手机导航。
Download and install / 下载与安装
Download codexview-6.2.1, then run these commands in the download directory:
下载无扩展名的 codexview-6.2.1,在下载目录执行:
mkdir -p "$HOME/.local/bin"
cp codexview-6.2.1 "$HOME/.local/bin/codexview"
chmod +x "$HOME/.local/bin/codexview"
export PATH="$HOME/.local/bin:$PATH"
codexview --versionFor local access / 本机访问:
codexview serveOpen / 打开 http://127.0.0.1:17864/ .
For a server or container / 服务器或容器部署:
codexview serve --host 0.0.0.0 --port 80Use the mapped host port when accessing a container. / 容器部署时使用映射后的宿主机端口访问。
English README · 中文 README · MIT License
Assets / 附件
codexview-6.2.1: standalone program / 单文件程序。- ZIP and tar.gz: complete source, documentation and tests / 完整源码、文档与测试。
- Manifest and SHA256SUMS: source and download verification / 源码清单与下载校验值。
Preview limits / 预览版限制
First-time search of very large files can take several seconds and returns up to 200 matching records. This is a personal viewer without built-in login or multi-user access control; use a trusted network or authenticated proxy. Not every Codex CLI record format has been validated.
首次搜索大文件可能需要数秒,最多返回200条匹配记录。当前面向个人可信环境,不内置登录或多用户权限;公网访问需自行配置认证代理。尚未覆盖所有 Codex CLI 记录格式。