CodexHub v0.5.1

CodexHub v0.5.1 closes the upgrade and diagnostics loop.

Highlights:

• Fixes the TV wall unauthorized state. If the token is invalid, the wall now returns to the connection form instead of showing empty skeleton thread cards.
• Preserves existing server ADMIN_TOKEN, INSTALL_KEY, FCM, backup, and release settings during server upgrades.
• Preserves Windows desktop nodeKey and enrollment metadata during agent reinstalls.
• Adds Windows code-signing hooks across release packaging and emits codexhub-signing-report-v0.5.1.json.
• Adds scripts/verify-upgrade-closure.ps1 to verify release assets and SHA256 hashes.
• Adds code-signing and upgrade documentation.

Signing note:

• This release was built without a trusted Windows code-signing certificate configured, so Windows artifacts remain unsigned. Configure CODEXHUB_CODESIGN_THUMBPRINT or CODEXHUB_CODESIGN_PFX and rebuild to produce trusted signed binaries.

CodexHub v0.5.0

CodexHub v0.5.0 focuses on long-term stability and operability.

Highlights:

• Adds /health.html self-check report for server, token, storage, backup, FCM, node sync, command queue, and update checks.
• Adds a Health Report shortcut to the TV command center.
• Hardens Companion auto-repair with cooldown, post-restart verification, and persisted repair status.
• Prevents command queues from getting stuck forever by requeueing expired leases and marking repeated timeouts as failed.
• Adds a Chinese troubleshooting manual with an English quick reference.
• Rebuilds Android TWA APK and release packages for v0.5.0.

Notes:

• Windows Companion artifacts are unsigned unless you configure a code-signing certificate.
• Android APK is signed with the local CodexHub release keystore. Keep the generated keystore and credentials for future upgrades.

CodexHub v0.4.9

CodexHub v0.4.9

This release fixes the mobile/TV synchronization path and prepares a safer fleet-control dashboard release.

Highlights

• Fixed unread completion/update notifications so server-side node.attention items appear in the pending queue.
• Fixed a modal action bug where viewing context could mark a task as read.
• Added refresh in-flight protection and clearer failure feedback.
• Hardened SSE parsing so malformed realtime events do not break the dashboard.
• Synced default release versions across server, agent, companion installer, and packaging scripts.
• Added Go server tests for Agent proposal guardrails.

Notes

• Windows artifacts are unsigned unless you configure your own code-signing certificate.
• codexhub-android-twa-v0.4.9.zip is included. Direct APK generation hit a local Bubblewrap/Jimp icon parsing error and will be repaired separately.

CodexHub v0.4.8

CodexHub v0.4.8

• Windows agent packages now include node-runtime\node.exe.
• codexhub-farfield prefers the packaged Node runtime before falling back to NODE_EXE or system PATH.
• codex-wrapper.exe also prefers the packaged Node runtime when launching OpenAI Codex CLI.
• This means normal Windows desktop installs no longer require users to install Node.js separately for Farfield/Codex local relay startup.

Windows note: the Companion installer is still unsigned unless you sign it with your own certificate.

CodexHub v0.4.7

CodexHub v0.4.7

• Adds a native codexhub-farfield launcher for hidden/background Farfield startup.
• Bundles pinned Farfield runtime into Windows/Linux/macOS agent packages; login startup no longer uses npx @farfield/server@latest.
• Updates desktop installers and Companion repair logic to use the bundled runtime.
• Keeps the Android TWA APK at v0.4.6 because the TWA shell opens the live web console; web updates apply inside the app.

Windows note: the Companion installer is still unsigned unless you sign it with your own certificate.

CodexHub v0.4.6

CodexHub v0.4.6

中文

这个版本修复 Windows 端后台体验：

• 修复 Companion 自动修复逻辑重复拉起 agent.mjs，导致多个 agent 常驻的问题。
• Node 版 desktop agent 增加单实例锁，重复启动会自动退出。
• Companion 在 Windows 手动兜底启动时优先使用 codexhub-agent.exe，不再优先拉起 node.exe agent.mjs。
• Windows Go agent 改为 GUI 子系统构建，后台运行时不弹命令行窗口。
• Farfield 任务计划启动参数增加 -WindowStyle Hidden。

如果本机已经出现多个 node.exe ... desktop-agent\\agent.mjs，先退出旧 Companion，再结束这些进程，然后安装或启动本版本。

English

This release fixes the Windows background-agent experience:

• Prevented Companion auto-repair from launching duplicate agent.mjs processes when scheduled tasks are missing.
• Added a single-instance lock to the Node desktop agent.
• Made the Windows manual fallback prefer the native codexhub-agent.exe.
• Built Windows Go agent binaries with the GUI subsystem to avoid visible console windows.
• Added -WindowStyle Hidden for the Farfield scheduled PowerShell task.

CodexHub v0.4.5

CodexHub v0.4.5

中文

本版本把服务器侧可靠性补齐到生产部署可用的形态：

• SQLite 持久化：服务器默认可使用 /opt/codexhub/data/codexhub.db 保存状态。
• 自动备份：新增 codexhub-backup.timer，每天生成 /opt/codexhub/backups/codexhub-backup-*.tar.gz。
• FCM 真接入：改为 Firebase HTTP v1 + 服务账号 OAuth，不再只是预留 token 接口。
• Web/TWA 自动登记：配置 Firebase Web 参数后，手机网页或 TWA 会自动登记 FCM token。
• Go/Node 双运行时同步：正式包优先运行的 Go 服务器也具备 SQLite 和 FCM 能力。

服务器上推荐把 Firebase 服务账号放在：

/opt/codexhub/secrets/firebase-service-account.json

然后在 /opt/codexhub/codexhub.env 配置：

CODEXHUB_FCM_SERVICE_ACCOUNT_FILE=/opt/codexhub/secrets/firebase-service-account.json
CODEXHUB_FCM_PROJECT_ID=your-firebase-project-id
CODEXHUB_FIREBASE_WEB_CONFIG={"apiKey":"...","authDomain":"...","projectId":"...","messagingSenderId":"...","appId":"..."}
CODEXHUB_FIREBASE_VAPID_KEY=your-web-push-vapid-key

如果暂时没有 Firebase 配置，网页端待处理列表、SSE 实时刷新和手动刷新仍然可用。

English

This release improves server-side reliability for production self-hosting:

• SQLite persistence: server state can be stored in /opt/codexhub/data/codexhub.db.
• Automatic backups: codexhub-backup.timer creates daily archives under /opt/codexhub/backups.
• Real FCM support: Firebase HTTP v1 service-account OAuth replaces the previous placeholder-style registration path.
• Web/TWA registration: the web console can automatically register an FCM token when Firebase Web config is present.
• Go/Node parity: the packaged Go server and the development Node server now support the same SQLite and FCM behavior.

Recommended Firebase service-account path:

/opt/codexhub/secrets/firebase-service-account.json

Then set the FCM and Firebase Web environment values in /opt/codexhub/codexhub.env and restart codexhub.service.

CodexHub v0.4.4

CodexHub v0.4.4

中文

本版本把前面 1 到 10 个方向做成可落地的运维闭环：

• 通知：新增 Webhook/FCM 投递钩子、推送令牌登记和测试接口。
• 节点状态：桌面端心跳增加序号、采集时间、Agent 启动时间和更新元数据。
• 任务状态机：明确运行中、等待回复、待审批、已完成未读、失败和已读归档。
• 手机消息中心：新增未读、待处理、已完成、失败和全部筛选。
• 安装体验：Windows/Linux/macOS 安装脚本写入预检诊断文件。
• 管理后台：设置页展示只读密钥、安卓 APK、今日运营数据、存储状态和推送测试。
• 数据持久化：状态文件增加 schema/storage 元数据，并预留 CODEXHUB_STORAGE=sqlite 迁移开关。
• 会话读取：最近消息同步用户/助手上下文，方便手机端判断进度。
• 自动更新：发布包生成 SHA256 release manifest，供后续静默更新校验。
• 大屏/日报：今日完成、更新线程和失败命令进入云端 totals/reports。

English

This release turns the ten requested directions into a practical operations loop:

• Notification hooks for Webhook/FCM delivery, push token registration, and push testing.
• More accurate node status with heartbeat sequence, collection time, agent start time, and update metadata.
• Explicit task states for running, waiting reply, waiting approval, completed unread, failed, and archived.
• Mobile inbox filters for unread, pending, completed, failed, and all items.
• Installer preflight diagnostics for Windows, Linux, and macOS.
• Admin/settings panel surfaces readonly token, Android APK, daily operations data, storage status, and push testing.
• Persistence metadata and a CODEXHUB_STORAGE=sqlite migration switch for future SQLite-backed history.
• Richer session sync with recent user and assistant context.
• Release manifest generation with SHA256 checksums for update verification.
• Daily report metrics for completions, updated threads, and failed commands.

CodexHub v0.4.3

CodexHub v0.4.3

中文

本版本覆盖 7 个稳定性和规模化方向：

• Companion 增加 GitHub Release 更新检查，并在后台定期检查新版本。
• Companion 增加本机服务自动修复开关，会尝试拉起 Farfield 和 agent。
• Web/PWA 增加浏览器通知，新的未读任务可以触发系统通知权限。
• 云端支持 CODEXHUB_READONLY_TOKEN 只读令牌，可用于大屏或旁观设备。
• 任务详情同步最近 20 条 Codex 输出，方便回看更完整上下文。
• 安装信息改为基于服务器 /downloads 的一键下载/解压/安装命令。
• 大屏看板增加今日完成和失败命令统计，实时队列也显示最近完成内容。

English

This release covers seven reliability and fleet-operation improvements:

• Companion can check GitHub Releases for updates and performs a background update check.
• Companion adds an auto-repair toggle that attempts to restart Farfield and the local agent.
• The Web/PWA console can use browser notifications for new unread work items.
• The cloud server supports CODEXHUB_READONLY_TOKEN for read-only dashboards.
• Task details now sync up to 20 recent Codex messages for better context.
• Install profiles now use one-line download/extract/install commands from server /downloads.
• The TV dashboard now shows today's completions and failed command counts.

CodexHub v0.4.2

CodexHub v0.4.2

中文

本版本重点增强手机端远程控制的闭环体验：

• 任务详情新增同步时间线：云端记录、手机指令排队、桌面端接收、转发 Codex、Codex 回复状态一屏可见。
• 任务详情新增最近消息列表，从本地 Codex session 中同步最近输出，便于手机端判断任务进展。
• 手机指令失败会自动进入未读通知，避免“显示已发送但实际失败”的情况被忽略。
• 节点列表新增搜索和筛选：可按电脑名、主机名、标签、最近任务检索，并筛选运行中、同步注意、同步异常。
• 同步诊断继续保留云端、Farfield、Codex 会话、命令回执、未读通知五段检查。
• Service Worker 缓存升级到 codexhub-v18，手机端重新打开后会加载新版页面。

English

This release improves the mobile remote-control loop:

• Task details now include a delivery timeline covering cloud record, mobile queue, desktop pickup, Codex forwarding, and Codex reply status.
• Task details now show recent Codex session messages so mobile users can understand current progress before replying.
• Failed mobile commands now create unread notifications instead of silently staying in command history.
• Node management now supports search and filters for running nodes, sync warnings, and sync errors.
• Sync diagnostics continue to cover cloud heartbeat, Farfield, Codex session reads, command receipts, and unread notifications.
• Service Worker cache has been bumped to codexhub-v18.