This repository offers a curated collection of dotfiles designed for macOS users to automate the setup and configuration of their development environment. It serves as a personal template, enabling users to quickly establish a consistent workspace or to learn from and adapt its structure for their own needs.

How It Works

The core of the setup involves cloning the dotfiles repository into ~/.dotfiles. Subsequently, users execute a series of shell scripts to manage their environment. setup-brew.sh handles the installation of essential command-line tools and applications via Homebrew. setup-macos.sh applies system-level macOS configurations, while setup-symlinks.sh creates symbolic links, ensuring that applications correctly reference the configuration files within the repository. A specific section details the manual setup of MCP servers for the 'Claude' tool, managing server connections for specific applications like MDN and Safari Technology Preview.

Quick Start & Requirements

• Primary Install:
  1. Ensure Homebrew is installed.
  2. Clone the repository: git clone https://github.com/pawelgrzybek/dotfiles.git ~/.dotfiles
  3. Execute setup scripts:
     • source ~/.dotfiles/setup-brew.sh (Installs Homebrew packages)
     • source ~/.dotfiles/setup-macos.sh (Configures macOS settings)
     • source ~/.dotfiles/setup-symlinks.sh (Sets up symbolic links)
• Prerequisites: macOS operating system, Homebrew package manager.
• Optional: Manual download of specific App Store applications (Keynote, Numbers, Pages, Photomator, Pixelmator Pro).
• Specific Tool Setup: Manual configuration for 'Claude' MCP servers is required post-setup.

Highlighted Details

• Automated installation and management of Homebrew formulas and casks.
• System-wide macOS configuration applied via script.
• Centralized management of application configurations through symbolic links.
• Includes specific instructions for integrating the 'Claude' tool with MCP servers for tools like MDN and Safari Technology Preview.

Maintenance & Community

No information regarding contributors, community channels (like Discord/Slack), or project roadmap is present in the provided README snippet.

Licensing & Compatibility

The repository's license and compatibility notes for commercial use or integration with closed-source projects are not specified in the provided text.

Limitations & Caveats

The repository's author explicitly warns that the included settings are "highly personal and certainly not suitable for everyone." Users are strongly advised against direct application and encouraged to use it as a foundation for creating their own customized dotfiles, implying potential conflicts or unexpected behavior if applied without modification.