claude-dotfiles
Sync your Claude Code configuration across every machine via git.
What it is
claude-dotfiles is a lightweight, tool-agnostic framework for version-controlling your Claude Code global configuration and syncing it across machines via git.
The core idea: keep your CLAUDE.md in a git repository and symlink ~/.claude/CLAUDE.md to it on every machine. Machine-specific paths — where your projects live, what knowledge directories you use — stay in a local machine.json file that is never committed. One setup script handles everything.
Quick start
git clone git@github.com:Spyced-Concepts/claude-dotfiles.git ~/claude-dotfiles
bash ~/claude-dotfiles/scripts/setup.shThe setup script creates the symlink, writes a machine.json for your paths, and confirms everything is wired correctly. Works on macOS, Linux, and Windows (Git Bash).
Knowledge directories
claude-dotfiles introduces the concept of knowledge directories — paths to folders of markdown files that Claude reads for context. These can be Obsidian vaults, plain note folders, VS Code workspace docs, exported Notion pages, or any collection of markdown files. The framework makes no assumptions about what tools you use.
Built-in slash commands
v1.3.0 ships five ready-to-use slash commands that work from the moment setup completes: /daily, /todo, /week-review, /journal, and /health-check.
Licence
MIT licence. Contributions are welcome — see CONTRIBUTORS.md for how to get involved.
Senior technology expertise —
security-first, AI-aware.
From architecture and outsourced development to compliance, AI integration, and tooling setup — Spyced Concepts delivers senior-level expertise across the full stack.
- Security consulting & pen testing
- AI-powered development
- Software architecture
- Outsourced development
- Project management
- Jira & Confluence setup
- Compliance & GDPR readiness
- Test strategy & QA