What is codex-history-sync-tool-mac-account-api-switch?

If you use Codex Desktop on a Mac and you've ever switched between an OpenAI/Plus account login and an API login, you may have noticed your old conversations disappear from the sidebar, even though the data is still on your computer. Codex History Sync Tool fixes exactly that problem. It re-links your existing local chat history so it shows up again in Codex Desktop's sidebar after you switch login methods. The tool works by reading Codex's local configuration files and database to figure out which login method (called a "provider") your old conversations belong to, then updating the sidebar index and metadata so those conversations appear under your current login. Before making any changes, it automatically backs up your database and related files, so you can roll back if something goes wrong. You can trigger a sync with a single button, or turn on an optional setting that automatically syncs whenever Codex Desktop launches. There's also an advanced mode that quits and relaunches Codex for you before syncing, which is handy after switching accounts but not recommended for everyday use. This is for macOS users (11 or later) who run Codex Desktop and switch between account types, API providers, or models, for example, someone who logs in with an OpenAI Plus account at home but uses an API key at work, or someone who changed API providers and lost visibility of older threads. It's strictly a local tool: it doesn't sync conversations to the cloud, transfer chats between computers, or recover deleted files. Everything happens on your machine and no data is uploaded anywhere. The project ships as a standard Mac app you download and double-click. There are three versions depending on whether you already have Python installed and whether your Mac uses Apple or Intel chips, the "built-in Python" versions bundle their own runtime so you don't need to install anything yourself. Since the app isn't signed by an Apple Developer ID, macOS will warn you the first time you open it, you just right-click and confirm to get past that. The advanced restart feature requires granting Accessibility permission in macOS settings so the tool can confirm Codex's quit dialog automatically.