sync

Synchronize git-tracked `.claude/` and `.codex/` configuration files to home directories.

24|3|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/Borda/.home --skill sync-borda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync
Source: https://github.com/Borda/.home/tree/main/.claude/skills/sync
Command: npx skills add https://github.com/Borda/.home --skill sync-borda

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill synchronizes your project-specific configuration files (.claude/ and .codex/) to your home directory, ensuring consistency across your development environments.

Core Features & Use Cases

  • Configuration Synchronization: Keeps your AI assistant's settings and agent configurations up-to-date between your projects and your central home setup.
  • Drift Detection: Identifies differences between project and home configurations before applying changes.
  • Use Case: After setting up a new project with custom AI agent configurations, use this Skill to seamlessly transfer those settings to your global AI assistant configuration.

Quick Start

Run the sync skill to see what configuration changes would be applied.

Frequently Asked Questions about sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync git-tracked configuration files to my home directory?

To sync git-tracked configuration files to your home directory, this skill uses rsync driven by git ls-files to copy only tracked files from project .claude/ and .codex/ directories to their home equivalents, prioritizing project files without deleting existing home directory content.

What is the best way to keep AI assistant settings consistent across multiple projects?

Keeping AI assistant settings consistent across projects is achieved by synchronizing git-tracked configuration files from project-specific .claude/ and .codex/ directories to your central home directory setup, ensuring uniform settings and agent configurations everywhere.

Does syncing project dotfiles exclude runtime state and secrets?

Yes, syncing project dotfiles excludes runtime state and secrets. The process uses git ls-files to ensure only git-tracked configuration files are synced, automatically filtering out untracked runtime state and sensitive files during the rsync operation.

Can I use rsync to transfer custom agent configurations without overwriting home files?

You can use rsync to transfer custom agent configurations without overwriting home files because this skill prioritizes project files and never deletes home directory content, ensuring existing configurations remain intact while applying tracked project updates.

How does dotfiles synchronization handle hook paths in settings.json?

Dotfiles synchronization handles hook paths in settings.json by automatically transforming them during the sync process, ensuring the hook paths remain valid and correctly mapped when configuration files are copied from the project directory to the home directory.

Why should I not manually copy .claude configuration directories?

You should not manually copy .claude configuration directories because manual copying risks including untracked secrets and runtime state, whereas this automated rsync approach uses git ls-files to safely sync only tracked files and transforms hook paths correctly.