.files

Personal dotfiles management tool that automatically sets up development environment configurations across multiple platforms.

Overview

Features

• Automatic symlink creation for dotfiles to home directory
• Cross-platform support (macOS, Windows, WSL)
• Cursor editor settings synchronization
• Selective file exclusion with .dotfilesignore

Usage

Setup

1. Clone this repository
2. Navigate to the repository directory
3. Run the setup script:

./setup.sh

This script will:

• Create symlinks for all dotfiles to your home directory
• Set up Cursor editor settings (macOS/WSL)

4. Restart your shell or run source ~/.zshrc
5. Install development tools: mise install

Note: The script will overwrite existing dotfiles in your home directory with symlinks.

Configuration

Excluding files

Use .dotfilesignore to exclude specific files from symlink creation. Supports directory patterns and wildcards.

Cursor settings sync

• macOS: Automatically syncs to ~/Library/Application Support/Cursor/User/settings.json
• WSL: Copies to Windows home directory (requires $WINDOWS_HOME environment variable)

System requirements

• Windows
• Windows Subsystem for Linux
• macOS

Troubleshooting

WSL Setup

For WSL users, set the WINDOWS_HOME environment variable:

export WINDOWS_HOME="/mnt/c/Users/YourUsername"

Existing Files

The setup script will remove existing files before creating symlinks. Back up important configurations before running.