codex-provider-sync CLI
Aligns provider data in old Codex sessions after a model provider change: session files and the SQLite index, with backups
- 3,576 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Edits Codex session files and the SQLite database
- The author does not guarantee that an old session can continue
- The Windows desktop version is unsigned
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/codex-provider-syncDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Edits Codex session files and the SQLite database
- The author does not guarantee that an old session can continue
- The Windows desktop version is unsigned
This is third-party code. Review the repository files before installing.
What it does
After changing the model provider in Codex, old sessions keep being listed under the former provider. codex-provider-sync aligns the provider data in session files and in the SQLite index. The author does not guarantee that an old session will be able to continue or compact. There are three entry points: a portable desktop version for Windows x64 without Node.js (unsigned), Local Web and a CLI installed with `npm install -g @dailin521/codex-provider-sync`. There are no Electron builds for macOS and Linux, but there is an old .NET version. The main README is in Chinese, and the English version is in `docs/README_EN.md`.
Who it is for. For people who changed the model provider in Codex and want to get access to old sessions back without editing files and the database by hand.
Good fit when
- After a provider change old Codex sessions vanished from the list or are bound to the former one
- You need a utility with backups and recovery instead of editing the database by hand
- You need a portable version for Windows without installing Node.js
Not a fit when
- You did not change the provider: the utility solves only that problem
- You need a desktop app build for macOS or Linux: there is none
Example request
Make a backup of the Codex data, align the provider in old sessions and show how many sessions were updatedLimitations
The utility edits Codex session files and the SQLite database, so before running check that backups are created and try it on a copy of the data. The author does not guarantee that an old session will be able to continue or compact. The Windows desktop version is unsigned. For macOS and Linux there are the CLI and Local Web but no Electron. The main README is in Chinese. The task is narrow: the utility is only needed after a provider change. The latest release is v1.0.4 from 28.09.2026.
How to disable. Remove the package with npm uninstall -g @dailin521/codex-provider-sync. If something went wrong, restore the Codex data from the backup the utility created.
FAQ
What problem does it solve?
After a model provider change old Codex sessions are listed under the former provider, and the utility aligns the data in session files and in the SQLite index.
Are there backups?
Yes, the utility makes backups and can restore data. Check this on your installation.
Which versions exist?
A portable desktop version for Windows x64, Local Web and a CLI. There are no Electron builds for macOS and Linux.
What language is the documentation in?
The main README is in Chinese, and the English version is in docs/README_EN.md.
Discussion
No questions or reviews yet.
Related
CLI toolsA Zig utility for switching Codex accounts: importing an auth file, listing, switching, for the CLI, VS Code and the app
Shows what Claude Code and Codex actually send to the API: it captures local traffic and splits tokens and cost by source
Token Optimizer
token-optimizer
A plugin for Claude Code and Codex: trims wasted tokens, keeps work alive across sessions and compactions and shows cost. The license is noncommercial
A self-hosted control center for coding agents: Claude Code, Codex, Copilot, OpenCode and Pi from your phone, desktop and terminal
Tokscale
tokscale
A CLI with an interactive TUI that tracks token usage and cost across AI coding agents: Claude Code, Codex, Copilot, Cursor and more
Claude Code Tools
claude-code-tools
A set of practical tools for Claude Code, Codex CLI and similar agents: utilities, skills, agents, hooks and plugins for terminal work
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| codex-provider-sync (this entry) | no | 3,576 | ||
| codex-auth | no | 2,797 | switches Codex accounts | |
| CodexPro | no | not required | 2,091 | a local MCP giving ChatGPT access to repositories through a tunnel |
README in short
The README describes a utility for aligning the provider in old Codex sessions after a change: three ways to run, backups and limitations. The main README is in Chinese, with an English version in docs. MIT license.