Is it safe to commit my Claude session history?

No, it is highly discouraged. History files can contain sensitive code, environment variables, or private data. This skill provides patterns to ensure logs and history are never committed.

Why shouldn't I track plugin metadata files?

Metadata files like installed_plugins.json contain absolute paths and timestamps specific to your local machine, which lead to merge conflicts and broken paths on other devices.

Can I version control my entire ~/.claude directory?

No, you should only track portable files like settings.json and CLAUDE.md. Machine-specific metadata, absolute paths, and logs should be ignored to prevent sync errors.

How do I sync my installed plugins across machines?

The recommended approach is to maintain a PLUGINS.md file documenting your marketplaces and plugins, then manually reinstalling them on new machines to allow Claude to regenerate local metadata.

Claude Code Config Version Control

Name: Claude Code Config Version Control
Author: bbrowning

bybbrowning

0•

Productivity & Workflow

Manages and syncs your Claude Code global configuration across multiple machines using Git best practices.

This skill provides a specialized framework for version controlling the ~/.claude directory, enabling developers to seamlessly synchronize their global instructions and preferences across different environments. It offers a pre-configured .gitignore template that identifies portable settings while strictly excluding machine-specific metadata, absolute paths, and sensitive session logs. By following this standardized workflow, users can maintain a consistent Claude Code experience without encountering merge conflicts or exposing private conversation history.

Key Features

01Optimized .gitignore template for Claude Code directories

020 GitHub stars

03Standardized documentation workflow for plugin management

04Protection against committing sensitive session and debug logs

05Step-by-step cross-machine synchronization guide

06Clear separation of portable settings versus machine-specific data

Use Cases

01Standardizing AI coding environments across a development team

02Backing up global plugin preferences and marketplace configurations

03Synchronizing Claude Code custom instructions between work and personal machines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bbrowning/bbrowning-claude-marketplace version-control-config

For use in Claude.ai and ChatGPT

Download Skill