This repository offers a comprehensive, automated system for managing macOS development environments via a custom dot CLI tool. It targets macOS developers seeking streamlined setup and maintenance, providing one-command provisioning and AI-powered development insights.

How It Works

The system uses a dot CLI tool built on GNU Stow for symlink management and Homebrew for package installation. It orchestrates setup for Fish shell, Neovim, Tmux, and Git. AI integration via OpenCode enables commit summaries. The architecture is modular for distinct work/personal configurations, with resilient package management that continues installations despite individual failures.

Quick Start & Requirements

• Prerequisites: macOS (Intel/Apple Silicon), internet, terminal.
• Installation: Clone (git clone https://github.com/dmmulroy/.dotfiles.git ~/.dotfiles), cd ~/.dotfiles, then ./dot init. Customization via --skip-ssh, --skip-font.
• Dependencies: Homebrew (auto-installs), Bun, OpenCode CLI.
• Documentation: README within the repository.

Highlighted Details

• One-Command Setup: Provisions environments via ./dot init.
• AI Integration: OpenCode for commit summaries and development assistance.
• Resilient Package Management: Continues installations if packages fail.
• Health Monitoring: dot doctor for comprehensive diagnostics.
• Modular Design: Supports separate work/personal configurations.
• Shell Performance Benchmarking: Analyzes Fish shell startup performance.

Maintenance & Community

Maintenance uses commands like dot update and dot doctor. No community channels (Discord, Slack) are linked in the README.

Licensing & Compatibility

The repository is for "personal use." While forkable and adaptable, it lacks a standard open-source license, potentially impacting broader redistribution or commercial integration.

Limitations & Caveats

Exclusively for macOS. AI features depend on OpenCode provider setup. The license is restrictive, intended for personal use only.