Dailin521

Dailin521 / codex-provider-sync

Public

Synchronize Codex session provider metadata across rollout files and SQLite state.

11
0
100% credibility
Found Mar 22, 2026 at 11 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A companion tool for the Codex chat app that synchronizes session history metadata to keep conversations visible after switching between different AI providers.

How It Works

1
😩 Chats disappear

You switch to a different AI helper in your chat app, and suddenly your old conversations vanish from the list.

2
🔍 Find the helper tool

You discover a simple companion tool designed to keep all your chat history visible no matter which AI you choose.

3
📥 Add the tool

You quickly bring this helper into your setup so it's ready whenever you need it.

4
🔎 Peek at your history

You check to see how your past chats are grouped by AI service right now.

5
Pick your move
🔄
Sync now

Match all chats to your current AI so they show up properly.

🔀
Switch AI

Jump to a new AI service and make sure your history follows along.

6
✨ Tool works its magic

It first saves a safe copy of your setup, then gently updates your chat records so everything stays in view.

🎉 All chats back!

Your full conversation history is now visible and organized, with a backup just in case.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 11 to 11 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is codex-provider-sync?

Codex-provider-sync is a JavaScript CLI tool that synchronizes Codex session provider metadata across rollout files in `~/.codex/sessions` and `~/.codex/archived_sessions`, plus the SQLite state in `state_5.sqlite`. It solves the common issue where switching model providers like OpenAI or Apigather hides old sessions in `codex resume` or the Codex App, keeping your history visible without manual fixes. Install via npm, then run `codex-provider sync` or `codex-provider switch openai` for instant sync.

Why is it gaining traction?

It stands out with automatic backups before changes, file locking to skip busy sessions, and rollback via `codex-provider restore`, minimizing risks during live use. Status checks via `codex-provider status` show provider counts in files and SQLite at a glance, plus Windows-specific lock detection handles real-world interruptions. Developers appreciate the one-shot AI prompt for agents, bridging manual CLI and automation.

Who should use this?

Codex power users switching providers frequently, like AI experimenters toggling between OpenAI and custom APIs. Teams managing shared `~/.codex` setups where session visibility breaks across rollouts. Anyone debugging provider mismatches in `codex resume` or apps without rewriting histories.

Verdict

Grab it if you're deep in Codex workflows—solid docs and MIT license make it low-risk, despite 11 stars and 1.0% credibility signaling early maturity. Test on a backup first; lacks broad adoption but nails a niche pain point effectively.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.