Dotfiles

Personal configuration files for Francesco Michieli (@info618).

Structure

dotfiles/
├── claude/.claude/          # Claude Code configuration
│   ├── CLAUDE.md           # Global instructions
│   ├── settings.json       # Hooks and permissions
│   ├── hooks/              # Security and quality hooks
│   └── skills/             # Custom skills
└── .stow-local-ignore      # Files to exclude from symlinking

Installation

Option 1: Quick Setup Script (Recommended for macmini/macstudio)

Use the automated sync script:

# Clone repository
git clone https://github.com/info618/dotfiles.git ~/dotfiles
cd ~/dotfiles

# Run sync script
chmod +x sync-claude-settings.sh
./sync-claude-settings.sh

To update later:

cd ~/dotfiles
./sync-claude-settings.sh

Force reinstall (if needed):

cd ~/dotfiles
./sync-claude-settings.sh --force

Option 2: Using GNU Stow (Advanced)

Prerequisites:

• GNU Stow: brew install stow
• Git: brew install git

Setup:

1. Clone this repository:

   cd ~
   git clone git@github.com:info618/dotfiles.git
   cd dotfiles

2. Install configuration using GNU Stow:

   # Install Claude Code config
   stow claude

3. Verify symlinks:

   ls -la ~/.claude/

Making Changes

1. Edit files in ~/dotfiles/claude/.claude/
2. Changes are automatically reflected in ~/.claude/ via symlinks
3. Commit and push:

   cd ~/dotfiles
   git add -A
   git commit -m "Update Claude config"
   git push

What's Included

Claude Code Configuration

• Global CLAUDE.md: Security gatekeeper and scaffolding rules
• Security Hooks: Block .env access, dangerous commands
• Quality Hooks: Auto-format code after edits
• Skills: Custom commands for commit messages and security audits

Hooks

• block-secrets.py - Prevents reading .env files
• block-dangerous-commands.sh - Blocks rm -rf, force push, etc.
• after-edit.sh - Auto-formats code (Prettier, Black, Ruff, etc.)

Syncing Across Machines

1. Machine A: Make changes, commit, push
2. Machine B: Pull changes

   cd ~/dotfiles
   git pull

3. Changes automatically appear via symlinks

Uninstalling

To remove symlinks (keeps your actual config):

cd ~/dotfiles
stow -D claude

Repository

• GitHub: info618/dotfiles
• Owner: Francesco Michieli

Last Updated

2026-01-16