skills.rest
JayHome137
JayHome137COMMUNITY
Explore all skills by this author →
GitHub

codex-session-provider-sync

Detect and repair Codex session metadata across provider-switching tools.

Updated Aug 27, 2026
Search Tags:#codex#session management#backup#data repair#provider detection
One-click install
npx skills add https://github.com/JayHome137/Codex-Session-sync --skill codex-session-provider-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-session-provider-sync
Source: https://github.com/JayHome137/Codex-Session-sync/tree/main
Command: npx skills add https://github.com/JayHome137/Codex-Session-sync --skill codex-session-provider-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

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

Frequently Asked Questions about codex-session-provider-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my Codex sessions missing after switching API providers?▼

Missing Codex sessions after a provider switch happen because session metadata retains outdated model_provider values. This Skill detects the active provider and repairs session files to restore visibility across CCX, CCSwitch, and Codex++.

How do I check Codex session consistency across multiple tools?▼

Run the detection script with the --json flag to check Codex session consistency. It identifies the current model_provider across CCX, CCSwitch, Codex++, and Cockpit Tools, then outputs provider names and their respective session counts.

Can I repair Codex session metadata without losing my existing history?▼

Yes, repairing Codex session metadata is safe. The Skill aligns session files with the current model_provider while automatically creating backups of the original data, ensuring you can roll back any changes if needed.

Does this session repair tool work with custom Codex providers?▼

Yes, this session repair tool supports custom Codex providers. It detects the active model_provider by evaluating native Codex, CCX, CCSwitch, Codex++, Cockpit Tools, and custom configurations to align session metadata accurately.

What do I need to run the Codex session provider sync script?▼

You need Python and relevant third-party libraries installed, plus read and write access to your Codex configuration and session files. These dependencies are required to detect the active provider and execute metadata repairs.

Related Skills

Explore More Software Engineering Skills→
7a336e6e7a336e6e
1

auditing-dependencies

Analyze third-party libraries for vulnerabilities and supply chain risks.

Community
Intermediate
dongzhuoyaodongzhuoyao
10

memory-sync

Synchronize canonical project memory with generated AGENTS.md and CLAUDE.md files.

Community
Intermediate
akiomikakiomik
10

docs

Aggregate and index SMT1-note documentation with markdown frontmatter and sidebar metadata.

Community
Basic
tkerseytkersey
66

seq

Parse Codex JSONL session logs to extract skill usage and token counts.

Community
Basic