Codex Provider Sync is a tool that synchronizes Codex session provider metadata across rollout files and SQLite state.
When switching between providers in Codex, old sessions may retain references to their original provider, causing metadata inconsistencies. This tool aligns session files and SQLite chat indices to match the current provider configuration. It does not guarantee that sessions will continue working across different providers or accounts, nor does it handle login, authentication, or encrypted content. Synchronization is unnecessary when provider information is already consistent.
The tool suits developers who have switched providers using external tools like CCSwitch and need to realign their session history, or those who prefer to switch providers directly within this tool. It offers three interfaces—a Windows desktop application, a local web UI accessible through a browser, and a command-line interface—all sharing the same underlying synchronization logic. The desktop version requires no Node.js installation, while the web and CLI versions require Node.js. Users should choose based on their workflow: the desktop application for routine use, the web UI for cross-platform environments, or the CLI for scripting and automation.
Development activity shows consistent maintenance with regular updates addressing user needs. The project maintains comprehensive documentation across multiple languages and provides detailed guides for each interface. Backup and recovery functionality is built in with automatic backups before modifications. The tool includes diagnostic features and targeted repair options for custom data locations. The project demonstrates responsiveness to user feedback through version updates and migration documentation for legacy users.
