You Should Be Versioning Your ~/.claude Config

If you’ve been using Claude Code for a while, you’ve probably accumulated a decent amount of configuration: settings, skills, custom agents, CLAUDE.md instructions. Losing all of that would be annoying. The fix: git init inside ~/.claude , with some caveats. What lives in ~/.claude Based on the official docs , here’s what’s worth versioning: CLAUDE.md settings.json skills/**/SKILL.md agents/<name>.md commands/<name>.md statusline.sh What to ignore Claude Code generates transient data that you should ignore. Add this to your .gitignore . # Credentials .credentials.json credentials.json # Internal state .claude.json .claude.json.backup.* security_warnings_*.json stats-cache.json mcp-needs-auth-cache.json # Session data history.jsonl backups cache debug file-history paste-cache session-env shell-snapshots # Agent and team state plans plugins tasks teams todos # Telemetry statsig telemetry usage-data # IDE integration ide/ Note about projects The projects/ directory contains per-project au