Skills
.Work. You
Rest

codex-session-provider-sync

Community

Ensure Codex session consistency across providers

Software Engineering#codex#session management#backup#data repair#provider detection
AuthorJayHome137
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill addresses the issue of missing or inconsistent Codex session history after switching API providers or using CCX, CCSwitch, Codex++, Cockpit Tools, and custom providers.

Core Features & Use Cases

  • Session Consistency Check: Identifies and corrects inconsistencies in model_provider values across session files and configurations.
  • Provider Detection: Determines the current provider for Codex sessions, considering multiple tools like CCX, CCSwitch, Codex++, Cockpit Tools, and native Codex.
  • Data Repair and Backup: Safely repairs session metadata to match the current provider, while maintaining backups for potential rollbacks.
  • Use Case: If you've switched providers and notice some sessions are missing from Codex, this Skill can help diagnose and fix the issue.

Quick Start

Run the skill with the --json flag to detect and list the current providers and their session counts:

python3 ~/.codex/skills/Codex-Session-sync/scripts/detect_provider_tool.py --json

Dependency Matrix

Required Modules

python

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: codex-session-provider-sync
Download link: https://github.com/JayHome137/Codex-Session-sync/archive/main.zip#codex-session-provider-sync

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.