dotfiles

Provision and manage dotfiles across macOS and Linux with Ansible playbooks.

2|Updated Oct 1, 2024
One-click install
npx skills add https://github.com/ZeiZel/dotfiles --skill dotfiles-zeizel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotfiles
Source: https://github.com/ZeiZel/dotfiles/tree/main
Command: npx skills add https://github.com/ZeiZel/dotfiles --skill dotfiles-zeizel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The dotfiles skill automates the provisioning and organization of a developer's personal configuration across macOS and Linux, reducing setup time and ensuring consistency.

Core Features & Use Cases

  • Idempotent environment bootstrap with Ansible playbooks, Brewfile, and stow-based symlinks
  • Cross-platform dotfiles management (macOS/Linux) with Zsh, Tmux, Neovim, and helper tooling
  • Drift control to keep machines in sync, with automated updates and re-provisioning
  • Optional agent-based workflow integration to streamline multi-agent dotfiles customization

Quick Start

Run the bootstrap script to install prerequisites and apply the Ansible playbooks to configure your dotfiles on a fresh host.

Frequently Asked Questions about dotfiles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate dotfiles provisioning across macOS and Linux?

Automate dotfiles provisioning by using Ansible playbooks to coordinate dependency installation, shell configurations, and stow-based symlinks. This applies configurations idempotently across macOS and Linux, ensuring consistent environment setup and reducing manual configuration time.

What is the best way to manage dotfiles symlinks for Zsh, Tmux, and Neovim?

Managing dotfiles symlinks with stow organizes configurations for Zsh, Tmux, and Neovim into a centralized structure. This approach creates reproducible symlinks, keeping your editor and shell settings synchronized across multiple machines without manual linking.

Can I use Ansible playbooks to keep developer environments in sync?

Yes, Ansible playbooks keep developer environments in sync by applying idempotent configurations and drift control. Running the bootstrap script re-applies the playbooks and Brewfile, automatically updating and re-provisioning machines to maintain consistent dotfile states.

Does this dotfiles management approach support both Homebrew and apt/dnf?

This dotfiles management approach supports both Homebrew and apt/dnf for cross-platform dependency installation. The Ansible playbooks coordinate package management across macOS and Linux, applying system-specific dependencies consistently through a unified Brewfile and provisioning process.

How do I bootstrap a fresh host with my dotfile configurations?

Bootstrap a fresh host by running the bootstrap script to install prerequisites and apply Ansible playbooks. This automatically configures your dotfiles, installs dependencies via Homebrew or apt/dnf, and establishes stow symlinks for a fully reproducible setup.

Why use stow for dotfiles config-management instead of manual symlinks?

Stow provides config-management for dotfiles by automating symlink creation rather than relying on manual linking. This ensures idempotent, reproducible setups that prevent broken links and maintain organized configuration directories across both macOS and Linux environments.