Repolode
Submit
Dailin521

Dailin521/codex-provider-sync

Syncs the model provider recorded in Codex session files and SQLite index so old sessions match the current provider config.

View on GitHub
Stars
3,597
Forks
147
Open issues
3
Last commit
22 days ago

What is it?

When you switch the model provider used by Codex, existing session files and the SQLite chat index can still record the previous provider. codex-provider-sync aligns that provider metadata with the current configuration, so the mismatch is resolved without changing chat content.

The tool can preview or apply the sync, optionally run automatically, and switch providers itself by updating the config before syncing. It backs up files before any change and supports restore and cleanup. Sessions can be browsed by project, and each operation's results and timing are logged.

It ships as a Windows desktop app (x64, unsigned), a local Web UI, and a CLI installed from npm. All three share the same sync, switch, backup and restore logic. It does not guarantee that old sessions across different providers or accounts can continue or be compacted, and it does not touch login files.

Key features

  • 01Previews or applies provider sync between session files and SQLite index.
  • 02Creates backups before changes and supports restore and cleanup.
  • 03Switches the active provider and syncs history in one step.
  • 04Browses sessions by project and logs operation results and timing.
  • 05Offers a Windows desktop app, a local Web UI, and an npm CLI.

Use cases

  • Fixing Codex sessions that still show an old provider after switching providers with another tool.
  • Running provider sync from scripts or inside WSL with the CLI.
  • Managing provider switches through a local browser UI on another machine over SSH.

Quick start

  1. 1

    Install Node.js 16.20.2 or later

  2. 2

    Install the CLI/Web package globally

    npm install -g @dailin521/codex-provider-sync
  3. 3

    Start the local Web UI

    codex-provider web

Things to know

  • The Windows desktop app is unsigned and no macOS or Linux Electron build has been released yet.
  • Syncing does not guarantee that old sessions can continue or compact across different providers or accounts.
  • The npm CLI/Web version requires Node.js 16.20.2 or later.

Topics

#codex-cli#openai-codex#sqlite#session-management#model-provider#nodejs#desktop-app#avalonia#codex-desktop#dotnet

FAQ

What is codex-provider-sync?
Syncs the model provider recorded in Codex session files and SQLite index so old sessions match the current provider config. When you switch the model provider used by Codex, existing session files and the SQLite chat index can still record the previous provider. codex-provider-sync aligns that provider metadata with the current configuration, so the mismatch is resolved without changing chat content.
Is codex-provider-sync free to use? What license does it have?
codex-provider-sync is open source under the MIT license. Check the license terms before using it in commercial products.
Is codex-provider-sync still maintained?
Actively maintained. The last commit to codex-provider-sync was on Sep 28, 2026.
What can I use codex-provider-sync for?
Fixing Codex sessions that still show an old provider after switching providers with another tool. Running provider sync from scripts or inside WSL with the CLI. Managing provider switches through a local browser UI on another machine over SSH.
How do I install codex-provider-sync?
Install Node.js 16.20.2 or later Install the CLI/Web package globally: npm install -g @dailin521/codex-provider-sync Start the local Web UI: codex-provider web
Where can I get codex-provider-sync?
The source code and installation instructions are on GitHub: https://github.com/Dailin521/codex-provider-sync

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects