dotfiles  by harperreed

Personal dotfiles for cross-platform configuration

Created 5 years ago
328 stars

Top 82.9% on SourcePulse

GitHubView on GitHub
Project Summary

Personal dotfiles for macOS and Arch Linux, managed with yadm. This repository offers a curated set of configurations for shells, development tools, and desktop environments, enabling users to quickly adopt or adapt a pre-configured system setup.

How It Works

The project leverages yadm to manage dotfiles, extending git for version control. A platform-aware yadm bootstrap command orchestrates the setup, dispatching to OS-specific scripts (common, darwin, linux) within .config/yadm/bootstrap.d/ to apply configurations tailored to the user's environment.

Quick Start & Requirements

  • Install: yadm clone git@github.com:harperreed/dotfiles.git followed by yadm bootstrap.
  • Prerequisites: yadm is the primary management tool. Specific configurations may require their respective applications (e.g., Fish shell, Hyprland, Hammerspoon).
  • Note: These are personal configurations, not a framework. Users are advised to borrow selectively rather than installing blindly.

Highlighted Details

  • Fish shell configuration (.config/fish/).
  • Git configuration and global hooks (.gitconfig, .git_hooks/).
  • macOS defaults script (.config/macos/set-defaults.sh) and Hammerspoon integration (.hammerspoon/).
  • Hyprland window manager and Waybar status bar configurations for Arch Linux (.config/hypr/, .config/waybar/).
  • Agent configurations for Claude and Codex (.claude/, .codex/).
  • SSH client hardening (.ssh/config).

Maintenance & Community

No specific details on contributors, sponsorships, or community channels were found in the provided README.

Licensing & Compatibility

  • License: MIT.
  • Compatibility: The MIT license generally permits broad use, including commercial applications and linking with closed-source projects, with minimal restrictions.

Limitations & Caveats

These are one individual's living configurations, not a generalized framework. Users are strongly cautioned against blind installation and encouraged to selectively integrate useful components.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
5 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.