Skill

Claude Sync

Knowledge about Claude Code sync architecture and cross-machine context sharing

npx claudepluginhub wsagency/ws-claude-marketplace --plugin ws-claude-sync

Tool Access

This skill uses the workspace's default tool permissions.

Preview

This skill provides knowledge about syncing Claude Code contexts, settings, and sessions across machines using Git.

Supporting Assets

examples/common-workflows.mdreferences/config-reference.mdreferences/sync-architecture.md

SKILL.md

Similar Skills

cache-components

139.2k

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

canvas-design

124.2k

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

20 files

anthropics-skills-13

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitFeb 14, 2026

Actions

View Source View Plugin View on GitHub View README

Claude Sync

This skill provides knowledge about syncing Claude Code contexts, settings, and sessions across machines using Git.

Overview

Claude Sync enables cross-machine synchronization of Claude Code data via a private GitHub repository. It supports two sync levels:

Level

What's Synced

Use Case

Essential

Config, settings, CLAUDE.md, sessions, todos

Daily sync between machines

Full

Essential + shell snapshots, slash commands

Complete environment replication

Architecture

The sync system uses a staging-based approach:

Prepare: Copy local Claude data to a staging area tagged with machine ID

Push: Commit staged data to Git repository

Pull: Fetch remote data and merge into local Claude directories

Merge: Intelligently merge configs (preserving local auth), append sessions, update files

Key Paths

Item

Path

Description

Config

~/.claude-sync/config.json

Sync configuration

Staging

~/.claude-sync/data/staging/

Prepared data for sync

Repo

~/.claude-sync/data/repo/

Cloned Git repository

Claude config

~/.claude.json

Main Claude configuration

Settings

~/.claude/settings.local.json

Local settings

Sessions

~/.claude/projects/

Project session data

Todos

~/.claude/todos/

Todo items

Merge Strategy

Claude config (~/.claude.json): Merge projects/MCP servers, preserve local userID and oauthAccount

CLAUDE.md: Append unique sections from remote

Session data: Append mode (never overwrite existing sessions)

Other files: Update if remote is newer, backup existing

References

See references/config-reference.md for config file format

See references/sync-architecture.md for detailed architecture

See examples/common-workflows.md for usage patterns

Claude Sync

This skill provides knowledge about syncing Claude Code contexts, settings, and sessions across machines using Git.

Overview

Claude Sync enables cross-machine synchronization of Claude Code data via a private GitHub repository. It supports two sync levels:

Level	What's Synced	Use Case
Essential	Config, settings, CLAUDE.md, sessions, todos	Daily sync between machines
Full	Essential + shell snapshots, slash commands	Complete environment replication

Architecture

The sync system uses a staging-based approach:

Prepare: Copy local Claude data to a staging area tagged with machine ID
Push: Commit staged data to Git repository
Pull: Fetch remote data and merge into local Claude directories
Merge: Intelligently merge configs (preserving local auth), append sessions, update files

Key Paths

Item	Path	Description
Config	`~/.claude-sync/config.json`	Sync configuration
Staging	`~/.claude-sync/data/staging/`	Prepared data for sync
Repo	`~/.claude-sync/data/repo/`	Cloned Git repository
Claude config	`~/.claude.json`	Main Claude configuration
Settings	`~/.claude/settings.local.json`	Local settings
Sessions	`~/.claude/projects/`	Project session data
Todos	`~/.claude/todos/`	Todo items

Merge Strategy

Claude config (~/.claude.json): Merge projects/MCP servers, preserve local userID and oauthAccount
CLAUDE.md: Append unique sections from remote
Session data: Append mode (never overwrite existing sessions)
Other files: Update if remote is newer, backup existing

References

See references/config-reference.md for config file format
See references/sync-architecture.md for detailed architecture
See examples/common-workflows.md for usage patterns