session-sync

What problem does it solve?

Ensures development machines share a consistent project state by detecting configuration drift between the local repository and the remote origin, preventing accidental work on stale or diverging setups.

Core Features & Use Cases

• Branch and Sync Status: Reports current branch, ahead/behind counts, and working tree cleanliness.
• Configuration Drift Report: Compares local vs remote for tracked config files such as .claude/, .mcp.json, and CLAUDE.md and highlights local or remote changes.
• Inventory and Health Checks: Lists local agents and skills, flags missing or untracked items, and verifies essential files exist.
• Action Summary: Recommends exact git commands to resolve drift and can optionally perform a git pull when requested via a flag.
• Use Case: Before starting work on a shared Claude Code project, run this to confirm agents, skills, and MCP settings match the remote and to avoid merge conflicts.

Quick Start

Run the session-sync skill to verify branch status, detect configuration drift for .claude/, .mcp.json, and CLAUDE.md, list agents and skills, and receive recommended git actions or perform an optional pull.