What happens if there is a conflict during sync?

The sync is managed by the @fractary/codex SDK which uses Git handlers. If the CLI encounters a conflict that it cannot resolve via its internal logic, it returns a detailed error message for the user to address.

Can I see what will happen before I run a sync?

Absolutely. By enabling the 'dry_run' parameter, the skill will provide a detailed preview of which files would be added, updated, or deleted without actually performing the operations.

Which branches does the skill sync with?

The skill can sync with specific target branches or resolve branches automatically based on the environment parameter (e.g., mapping 'prod' to the 'main' branch).

Is the Fractary CLI required for this skill?

Yes, this skill delegates all core logic to the Fractary CLI via the cli-helper skill. You must have the CLI installed globally or available via npx.

Does Project Syncer perform deletions automatically?

Yes, but it includes a safety threshold. If the sync would delete more files than the configured limit, the operation fails and requires a manual override to prevent accidental data loss.

Project Syncer

Name: Project Syncer
Author: fractary

$fractary$ byfractary

•

콘텐츠 관리

Synchronizes documentation and files bidirectionally between individual projects and a central codex repository via the Fractary CLI.

Project Syncer is a specialized skill for the Fractary codex plugin designed to maintain consistency between distributed project repositories and a centralized 'codex' repository. It automates the bidirectional movement of documentation and code patterns, supporting environment-specific branching (dev, test, staging, prod) and granular file selection via glob patterns. By delegating all operations to the Fractary CLI, it provides enterprise-grade safety features including deletion thresholds to prevent data loss, dry-run previews, and automatic commit management, making it an essential tool for teams managing multi-repo documentation strategies.

주요 기능

01Dry-run capability to preview sync operations without making changes

022 GitHub stars

03Safety-first architecture with configurable deletion thresholds

04Bidirectional file synchronization between local projects and a central codex

05Environment-aware syncing that maps stages to specific repository branches

06Pattern-based file selection and exclusion using standard glob syntax

사용 사례

01Propagating global configuration or documentation standards from a central repo to individual projects

02Automating the synchronization of CLAUDE.md files and project guides across a large organization

03Centralizing documentation from multiple microservice repositories into a single knowledge base

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins project-syncer

For use in Claude.ai and ChatGPT

Download Skill