Codex History Sync Tool v1.6.1

v1.6.1

This patch release fixes two macOS app issues:

• Bundled Python builds now include the required backend runtime scripts in Contents/Resources, avoiding backend JSON parsing failures when the app starts.
• The advanced restart sync flow now quits Codex first, syncs while Codex is closed, reopens Codex, then performs a final cleanup pass. This prevents a small number of provider/model-mismatched threads from being written back during Codex startup.

Downloads

Situation	Download
You already have a working Python 3 + tkinter environment and want the smallest download	Codex-History-Sync-Tool-v1.6.1-Lite.dmg
You do not have Python installed, or the Lite build quits immediately, and your Mac has Apple Silicon (M1/M2/M3/M4 etc.)	Codex-History-Sync-Tool-v1.6.1-Apple-Silicon.dmg
You do not have Python installed, or the Lite build quits immediately, and your Mac has an Intel processor	Codex-History-Sync-Tool-v1.6.1-Intel.dmg

The Apple Silicon and Intel builds bundle their own Python/Tk runtime. They do not modify the user's system Python.

Accessibility Permission

The Advanced: Restart Codex and sync threads button needs macOS Accessibility permission so it can confirm Codex quit dialogs. If Codex does not fully close, or the tool shows an error while quitting/restarting Codex, open System Settings -> Privacy & Security -> Accessibility and enable Codex History Sync Tool.

If it is already enabled but still fails, remove Codex History Sync Tool from the Accessibility list, add /Applications/Codex History Sync Tool.app again, enable it, then quit and reopen the tool.

Checks

• All three DMGs were verified with hdiutil verify.
• The Apple Silicon DMG contains an arm64 executable.
• The Intel DMG contains an x86_64 executable.
• All three app bundles include the required backend runtime scripts.
• A temp Codex home sync test completed with no remaining provider/model/session-meta work.

SHA256

8defbf23505266bd75130b24f0e2a8b60dff7ba50ea241a0827b1ed55e4af6a7  Codex-History-Sync-Tool-v1.6.1-Apple-Silicon.dmg
61d39973d74c1741bf79315930eac9f973d89cbde8f1422e8679a49b06260990  Codex-History-Sync-Tool-v1.6.1-Intel.dmg
d6eb9502e40193eaf2f44efba29f51524ae80dd5cb20bb1951d67e8d0a21aea4  Codex-History-Sync-Tool-v1.6.1-Lite.dmg

Notes

The app is still not signed or notarized with an Apple Developer ID. If macOS blocks it as an unidentified developer app, use Finder right-click > Open or System Settings > Privacy & Security.

Codex History Sync Tool v1.6.0

v1.6.0

This release provides three macOS download packages so users can choose between a small Python-dependent app and fully bundled apps that include their own Python/Tk runtime.

Which DMG should I download?

Situation	Download
You already have a working Python 3 + tkinter environment and want the smallest download	Codex-History-Sync-Tool-v1.6.0-Lite.dmg
You do not have Python installed, or the Lite build quits immediately, and your Mac has Apple Silicon (M1/M2/M3/M4 etc.)	Codex-History-Sync-Tool-v1.6.0-Apple-Silicon.dmg
You do not have Python installed, or the Lite build quits immediately, and your Mac has an Intel processor	Codex-History-Sync-Tool-v1.6.0-Intel.dmg

The Apple Silicon and Intel builds bundle their own Python/Tk runtime. They do not modify the user's system Python and should not conflict with any Python already installed on the Mac.

Package sizes

• Lite: about 2.7 MB
• Apple Silicon bundled Python: about 16 MB
• Intel bundled Python: about 17 MB

Notes

The app is still not signed or notarized with an Apple Developer ID. If macOS blocks it as an unidentified developer app, use Finder right-click > Open or System Settings > Privacy & Security.

Codex History Sync Tool v1.5.3

v1.5.3

This release fixes a real macOS startup crash that could still happen on some machines even after v1.5.2.

What was happening

Some Macs have Apple CommandLineTools/System Python 3.9 with tkinter importable, but its Tk runtime crashes when a window is actually created. The previous launcher only checked import tkinter, so it could incorrectly select that Python and then the app would quit immediately before showing the installer prompt.

Crash reports for this failure commonly include:

/Library/Developer/CommandLineTools/.../Python3.framework
Tcl_Panic
TkpInit
Abort trap: 6

What changed

• The macOS app launcher now creates and destroys a hidden Tk window while checking each Python candidate.
• Broken CommandLineTools/System Python Tk environments are rejected before launching the UI.
• If no working Python 3 + Tk GUI environment is found, the existing python.org Python 3.13.13 installer prompt is shown.
• launch_ui_mac.command uses the same safer launcher path and also validates Tk window creation in source mode.

Still unsigned

The app is still not signed or notarized with an Apple Developer ID. If macOS blocks it as an unidentified developer app, use Finder right-click > Open or System Settings > Privacy & Security. That Gatekeeper warning is separate from this Tk crash fix.

Codex History Sync Tool v1.5.2

v1.5.2

• Adds an automatic Python 3 installer fallback in the macOS app launcher.
• If no usable Python 3 with tkinter is found, the app now asks before downloading the official python.org Python 3.13.13 installer.
• After installation, the launcher rechecks the runtime and continues opening the tool instead of silently exiting.
• Updates the README and app bundle version to 1.5.2.

If the app appears to quit immediately

The most common cause is that the Mac does not have a usable python3 with tkinter. The launcher writes diagnostics to:

~/Library/Logs/Codex History Sync Tool/launcher.log

This app is not signed or notarized with an Apple Developer ID, so macOS may show an unidentified developer warning on first open. That warning is not an app crash; open it with Finder right-click > Open, or allow it from System Settings > Privacy & Security.

Codex History Sync Tool v1.5.1

v1.5.1

• Fixes app launch behavior on Macs where python3 is missing from PATH or Python lacks tkinter.
• Adds launcher logging at ~/Library/Logs/Codex History Sync Tool/launcher.log.
• Shows a clear dialog instead of silently exiting when no usable Python tkinter runtime is found.

Note: this app still requires a local Python 3 with tkinter. Install python.org Python 3 if macOS shows the launcher dependency dialog.

Codex History Sync Tool v1.5

v1.5

• Fixes incomplete provider sync by rewriting every session_meta entry in rollout JSONL files.
• Separates database thread counts from session meta entry diagnostics so pending counts stay meaningful.
• Adds startup settle/retry behavior and updates model metadata during sync paths.

Codex History Sync Tool v1.4.2

Changes

• Make Refresh Status run in the background with immediate progress feedback.
• Add backend timeouts for refresh, restart sync, and auto-sync watcher paths.
• Keep OpenAI/Plus account detection through auth.json and current provider inference.

Asset

• Codex-History-Sync-Tool-v1.4.2.dmg
• SHA256: 6d5a64ac2718e6b1ec532f14a6345cfb75da66b5a1d052df027b8c01af9b8b51

Codex History Sync Tool v1.4.1

v1.4.1

Hotfix for the macOS DMG app launcher.

Fixed

• Fixed a launch issue where the DMG app could quit immediately if the launcher selected a Python without working tkinter support.
• The app launcher now checks candidate Python interpreters and only uses one that can import tkinter.
• Launcher arguments are forwarded correctly, so smoke tests and future command-line checks work through the app executable.

Validation

• Ran the app executable smoke test directly from the mounted DMG.
• Verified the DMG checksum with hdiutil verify.

Codex History Sync Tool v1.4

v1.4

This release focuses on making the macOS history sync flow safer and easier to install.

Added

• DMG installer package for direct macOS installation.
• Advanced Restart Codex and Sync Threads action for CC Switch or account/API switching workflows.
• UI guidance that marks the restart sync action as an advanced feature and recommends disabling automatic launch sync before using it.

Improved

• One-click sync now refreshes status first and only runs when movable threads exist.
• Automatic Codex launch sync now uses the same movable_threads rule, so model-only mismatches are synchronized too.
• Restart sync now runs in a background thread and reopens Codex via macOS open, avoiding UI freezes when Codex closes or restarts slowly.
• Advanced help text now wraps properly in the app window.

Validation

• python3 -m py_compile launch_ui_mac.py sync_backend.py auto_sync_watcher.py
• python3 launch_ui_mac.py --smoke-test
• hdiutil verify dist/Codex-History-Sync-Tool-v1.4.dmg

v1.2.0 macOS account/API switch support

Adds OpenAI/Plus account-login and API-login provider switching support for the macOS Codex History Sync Tool. Upstream: GODGOD126/codex-history-sync-tool and ruigod1/codex-history-sync-tool-mac. Release asset contains only the app bundle, no local Codex data.