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

byfractary

•

Gestión de Contenido

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

Acerca de

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.

Características Principales

Dry-run capability to preview sync operations without making changes
2 GitHub stars
Safety-first architecture with configurable deletion thresholds
Bidirectional file synchronization between local projects and a central codex
Environment-aware syncing that maps stages to specific repository branches
Pattern-based file selection and exclusion using standard glob syntax

Casos de Uso

Propagating global configuration or documentation standards from a central repo to individual projects
Automating the synchronization of CLAUDE.md files and project guides across a large organization
Centralizing documentation from multiple microservice repositories into a single knowledge base

Acerca de

Características Principales

Dry-run capability to preview sync operations without making changes
2 GitHub stars
Safety-first architecture with configurable deletion thresholds
Bidirectional file synchronization between local projects and a central codex
Environment-aware syncing that maps stages to specific repository branches
Pattern-based file selection and exclusion using standard glob syntax

Casos de Uso

Propagating global configuration or documentation standards from a central repo to individual projects
Automating the synchronization of CLAUDE.md files and project guides across a large organization
Centralizing documentation from multiple microservice repositories into a single knowledge base