Codex Taskboard

Codex Taskboard 是一个面向 macOS 与 Windows 的本地任务看板，用时间、运行状态和项目重新组织 Codex 任务，并可直接跳回对应的 Codex 对话。

特性

• 按“进行中 / 已完成 / 全部”和时间范围筛选任务
• 标准三栏模式与项目平铺的专注模式
• 直接通过 codex://threads/{threadId} 打开原 Codex 任务
• 任务完成后发送系统通知
• 浅色、深色与跟随系统主题
• macOS 使用原生 SwiftUI Universal Binary，支持 Apple Silicon 与 Intel
• Windows 使用原生 WPF self-contained 安装包，支持 Windows 10/11 x64
• 本地只读：不上传数据，不修改 Codex 数据库

运行条件

• macOS 14 Sonoma 或更高版本
• Windows 10 版本 2004 或更高版本（x64）
• 已安装并至少运行过一次 Codex
• Codex 数据库位于默认位置：macOS 为 ~/.codex/state_5.sqlite，Windows 为 %USERPROFILE%\.codex\state_5.sqlite

无需填写账号、Token 或数据库地址。Taskboard 会读取当前用户目录下的 Codex 数据。

下载与安装

访问产品页：http://www.zephyrtan.xyz/codex-taskboard/

当前公开构建使用临时签名，未进行 Apple Developer ID 公证。首次打开时：

1. 将 Codex Taskboard.app 拖到“应用程序”。
2. 在 Finder 中右键应用，选择“打开”。
3. 如果仍被拦截，前往“系统设置 → 隐私与安全性”，选择“仍要打开”。

正式无提示分发需要 Apple Developer Program 账号、Developer ID 签名和 Apple 公证。

本地构建

cd macos
swift run CodexTaskboardCoreCheck
./scripts/build-app.sh

Universal 发布包：

cd macos
./scripts/build-release.sh

生成的 .dmg、.zip 和 SHA256SUMS.txt 位于 macos/dist/。

Windows 安装包由 .github/workflows/build-windows.yml 在 Windows Runner 上构建。CI 会静默安装生成的 Inno Setup 安装器，并从实际安装目录执行数据库与状态解析自检。

数据与隐私

应用以 SQLite READONLY 模式打开 ~/.codex/state_5.sqlite，并只读解析任务 rollout 文件来判断运行状态。应用本身不包含网络请求，也不会写入 Codex 数据库、任务文件或项目目录。

任务标题和预览在显示前会遮蔽常见 Token、密钥和手机号格式，但下载和使用前仍建议自行审查本机任务标题是否适合在屏幕上展示。

项目结构

macos/      SwiftUI 应用和构建脚本
windows/    WPF 应用、安装器与 Windows 自检
website/    产品官网
docs/       产品截图

License

MIT