How do I install the Conversation Sync skill?

Run npx skillmds@latest add masharratt/conversation-sync in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Conversation Sync safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Conversation Sync?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Conversation Sync free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Conversation Sync?

masharratt (@masharratt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Conversation Sync by masharratt — Agent Skill

Name: Conversation Sync
Rating: 4.2 (5 reviews)
Author: masharratt

File contents

Conversation Sync Skill

Note: This skill references .codex/sessions which may be outdated. Verify session storage paths match your Claude Code version before use.

This skill copies Claude Code conversation session files from .codex/sessions to the repository's .claude.json file for context preservation and backup.

Purpose

When working across different environments (e.g., after WSL/Docker crashes), conversation history stored in .codex/sessions can be referenced in .claude.json to maintain context continuity.

Usage

# Sync conversations from last N days (default: 7)
./.claude/skills/conversation-sync/sync-conversations.sh --days 7

# Sync conversations from a specific project
./.claude/skills/conversation-sync/sync-conversations.sh --project claude-flow-novice

# Sync conversations from a specific date range
./.claude/skills/conversation-sync/sync-conversations.sh --from 2025-11-20 --to 2025-11-26

# Dry run (show what would be copied)
./.claude/skills/conversation-sync/sync-conversations.sh --dry-run

What It Does

Searches .codex/sessions for conversation JSONL files
Filters by project working directory (if specified)
Filters by date range
Creates/updates .claude.json with references to conversation files
Preserves existing conversations in .claude.json

Output Format

The skill updates .claude.json with this structure:

{
  "conversations": [
    {
      "session_id": "rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94",
      "date": "2025/11/24",
      "file": "/mnt/c/Users/masha/.codex/sessions/2025/11/24/rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94.jsonl"
    }
  ]
}

Notes

Conversation files remain in their original locations
Only references are added to .claude.json
Supports both Windows (/mnt/c/Users/...) and Linux paths with automatic normalization
Safe to run multiple times (idempotent)
Path normalization handles both backslashes (\) and forward slashes (/)
Case-insensitive matching for project filtering (works with mixed-case paths)

Location of Conversation Data

Primary: /mnt/c/Users/{username}/.codex/sessions/YYYY/MM/DD/*.jsonl
Alternate: ~/.codex/sessions/YYYY/MM/DD/*.jsonl
Docker mounts: /mnt/wsl/docker-desktop-bind-mounts/ (if applicable)

Requirements

jq - JSON processing
bash 4.0+
Access to .codex/sessions directory

---name: conversation-syncdescription: Sync conversation history from .codex/sessions to .claude.json for context preservation. Use when copying/syncing conversations, importing sessions, or backing up conversation context.---# Conversation Sync Skill**Note:** This skill references `.codex/sessions` which may be outdated. Verify session storage paths match your Claude Code version before use.This skill copies Claude Code conversation session files from `.codex/sessions` to the repository's `.claude.json` file for context preservation and backup.## PurposeWhen working across different environments (e.g., after WSL/Docker crashes), conversation history stored in `.codex/sessions` can be referenced in `.claude.json` to maintain context continuity.## Usage```bash# Sync conversations from last N days (default: 7)./.claude/skills/conversation-sync/sync-conversations.sh --days 7# Sync conversations from a specific project./.claude/skills/conversation-sync/sync-conversations.sh --project claude-flow-novice# Sync conversations from a specific date range./.claude/skills/conversation-sync/sync-conversations.sh --from 2025-11-20 --to 2025-11-26# Dry run (show what would be copied)./.claude/skills/conversation-sync/sync-conversations.sh --dry-run```## What It Does1. Searches `.codex/sessions` for conversation JSONL files2. Filters by project working directory (if specified)3. Filters by date range4. Creates/updates `.claude.json` with references to conversation files5. Preserves existing conversations in `.claude.json`## Output FormatThe skill updates `.claude.json` with this structure:```json{ "conversations": [ { "session_id": "rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94", "date": "2025/11/24", "file": "/mnt/c/Users/masha/.codex/sessions/2025/11/24/rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94.jsonl" } ]}```## Notes- Conversation files remain in their original locations- Only references are added to `.claude.json`- Supports both Windows (`/mnt/c/Users/...`) and Linux paths with automatic normalization- Safe to run multiple times (idempotent)- Path normalization handles both backslashes (`\`) and forward slashes (`/`)- Case-insensitive matching for project filtering (works with mixed-case paths)## Location of Conversation Data- **Primary**: `/mnt/c/Users/{username}/.codex/sessions/YYYY/MM/DD/*.jsonl`- **Alternate**: `~/.codex/sessions/YYYY/MM/DD/*.jsonl`- **Docker mounts**: `/mnt/wsl/docker-desktop-bind-mounts/` (if applicable)## Requirements- `jq` - JSON processing- `bash` 4.0+- Access to `.codex/sessions` directory

Frequently asked questions

Conversation Sync