CodexRelay v0.1.3

CodexRelay v0.1.3

Maintenance release focused on global session continuity, unassigned sessions, macOS settings polish, and Telegram command reliability.

Highlights

• Added a global session view with optional project association and recoverable session synchronization.
• Allowed unassigned sessions to run directly with risk-sensitive approval controls.
• Improved deleted and archived session reconciliation, including periodic background checks.
• Refined the macOS System page layout and changed long titles to round-based playback.
• Improved Telegram command parsing, session continuity, and task hand-off behavior.

See the bilingual README and CHANGELOG for the complete details.

首次打开

如果 macOS 拦截应用，请关闭提示，然后前往“系统设置 → 隐私与安全性”，点击“仍要打开”。详细步骤见中文 README。

Downloads

• Apple Silicon: CodexRelay-macos-arm64-v0.1.3.dmg
• Intel: CodexRelay-macos-x86_64-v0.1.3.dmg
• Integrity checks: SHA256SUMS.txt

CodexRelay 0.1.2

0.1.2 — 2026-09-04

CodexRelay 0.1.2 improves session continuity and makes Telegram interaction more predictable. / 本版本聚焦会话连续性和 Telegram 交互稳定性。

Highlights

• Reconciles locally bound conversations with Codex thread/list, including pagination.
• Hides conversations deleted or archived in Codex while retaining local history for recovery.
• Automatically selects the first valid conversation when the current one disappears.
• Performs session reconciliation at startup, every 60 seconds, and on /sessions; reconciliation pauses during active tasks.
• Normalizes Telegram commands, supports @bot suffixes and compatibility aliases, and rejects unknown slash commands explicitly.
• Telegram task occupancy is short-lived and released after completion, failure, or interruption, so returning to the Mac requires no manual hand-off.
• Adds regression coverage for runtime synchronization, deleted/restored conversations, active-task safeguards, and command routing.

主要变化

• 按 Codex thread/list 全量校准会话，支持分页。
• Codex 中删除或归档的会话会从 Telegram 列表隐藏，但本地历史仍保留以便恢复。
• 当前会话失效时自动切换到第一条有效会话。
• 应用启动、每 60 秒和 /sessions 时自动校准，任务运行期间暂停校准。
• Telegram 命令支持大小写、@bot 后缀和兼容别名，未识别命令会明确提示。
• Telegram 任务结束、失败或中断后自动释放短期占用，回到电脑端无需手动交接。
• 增加运行时同步、会话删除/恢复、活动任务保护和命令路由回归测试。

Verification

• Ruff: passed
• Mypy strict: passed
• Pytest: 116 passed
• Apple Silicon App/DMG build: passed
• App bundle version: 0.1.2
• Code-signature verification: passed
• Distributed packages are ad-hoc signed and not Apple-notarized. Follow the first-launch macOS security confirmation instructions in the README.

CodexRelay 0.1.1

0.1.1 — 2026-09-02

CodexRelay 0.1.1 is a stability and workflow release focused on safer approvals, clearer Telegram feedback, reliable project discovery, and release replacement detection.

Same-version replacement detection

• The updater now detects a rebuilt DMG even when the release tag remains v0.1.1, using the architecture-specific asset update time and the local app build time.
• The UI can offer the replacement package as a repair build instead of incorrectly reporting that no update exists.
• Added regression tests for newer and older same-version assets.

What changed since 0.1.0

Telegram task feedback

• Added an ephemeral progress message while Codex is processing a request.
• Progress stages are updated in place and throttled to avoid message spam.
• Progress messages are removed when the task finishes or fails.
• Telegram API support now includes editing and deleting messages.
• Added the Telegram command-menu entry for the current command set.
• Approval results are reported explicitly for both accepted and declined requests.

Safer approval behavior

• Added project-scoped “auto-allow within this project” handling.
• Auto-allow is fail-closed: network access, out-of-project paths, and unsupported permission shapes still require an explicit approval.
• Approval scope checks resolve paths before comparing them with the selected project root.
• Approval state remains bound to the current project and paired Telegram identity.

Project scanning and macOS permissions

• “Scan Projects” now synchronizes the active list with the current filesystem instead of only appending new records.
• Moved, renamed, missing, or no-longer-matching projects inside configured scan roots are hidden from the active list.
• Database records remain recoverable; project files are never deleted by scanning.
• Projects manually registered outside configured scan roots are preserved.
• Added access preflight checks when registering a project, during application startup, and before starting a task.
• macOS privacy-permission failures now produce actionable status messages instead of surfacing stale path errors during execution.

Codex continuity and persistence

• Extended the App Server integration to report turn progress.
• Preserved project-specific approval settings when starting or resuming Codex threads.
• Hardened task, turn, checkpoint, and project-state persistence and recovery paths.
• Fixed transient SQLite writer lock contention during concurrent startup/UI operations with bounded retry and backoff.
• Replaced the raw database-lock error shown to users with an actionable status message.
• Added regression coverage for approval scope, project reconciliation, persistence, task lifecycle, and Telegram progress behavior.

UI and diagnostics

• Improved pairing completion and project-status feedback in the menu-bar/settings UI.
• Reduced stale or raw filesystem error text shown in the compact panel.
• Updated user-facing documentation to describe synchronized scanning, permission preflight, and same-version repair updates.

Verification

• Ruff: passed
• Mypy strict: passed
• Pytest: 108 passed
• arm64 App build: passed
• Intel App build: passed on GitHub Actions
• App bundle version: 0.1.1
• Code-signature verification: passed
• DMG image builds: passed
• SHA-256 checksums: verified for both architecture-specific DMGs

Compatibility and known limits

• macOS Apple Silicon and Intel builds are supported.
• The distributed app remains ad-hoc signed and is not Apple-notarized.
• Codex CLI must already be installed and authenticated on the Mac.
• Telegram currently supports one-to-one private chats only.
• The first release line still allows one active task globally.

Latest same-version maintenance rebuild — 2026-09-04

• Rebuilt both macOS DMGs from commit b4c012f while keeping the release tag and version at v0.1.1.
• Included conversation selection, persistent conversation locking and hand-off, database migrations, Telegram routing improvements, Codex preflight continuity, and related UI/state updates.
• Verification for this rebuild: Ruff passed, Mypy strict passed, and Pytest 108 passed.
• This replacement is intentionally published under the same version so the updater's same-version repair detection can be tested.