Yadm

yadm Plugin

Yet Another Dotfiles Manager — manage dotfiles with Git, encryption, Jinja2 templates, and per-machine alternative files.

Commands

Repository Management

• yadm repo init — Initialize a new dotfiles repository
• yadm repo clone — Clone an existing dotfiles repository

File Management

• yadm file add — Add files to the repository
• yadm file list — List tracked files

Encryption

• yadm crypto encrypt — Encrypt private files
• yadm crypto decrypt — Decrypt private files

Configuration

• yadm config bootstrap — Run bootstrap script
• yadm alt create — Create alternative file symlinks

Utility

• yadm _ _ — Passthrough to yadm CLI

Usage Examples

• "Initialize a dotfiles repo"
• "Clone my dotfiles from GitHub"
• "Add .bashrc to my dotfiles"
• "Encrypt my SSH keys"
• "Run the bootstrap script"

Installation

brew install yadm

Or on Linux:

sudo apt install yadm

Or manually:

curl -fsSL https://github.com/yadm-dev/yadm/raw/master/yadm -o /usr/local/bin/yadm && chmod +x /usr/local/bin/yadm

Examples

# Initialize a new dotfiles repository
yadm repo init

# Clone an existing dotfiles repo
yadm repo clone https://github.com/user/dotfiles.git

# Add files
yadm file add ~/.bashrc ~/.gitconfig ~/.vimrc

# Commit and push (passthrough to git)
yadm _ _ commit -m "Add shell config"
yadm _ _ push

# List tracked files
yadm file list

# Encrypt private files (reads ~/.config/yadm/encrypt for patterns)
yadm crypto encrypt

# Decrypt private files
yadm crypto decrypt

# Create alternative file symlinks (for per-OS configs)
yadm alt create

# Run bootstrap
yadm config bootstrap

# Show status
yadm _ _ status

# View version
yadm _ _ version

Key Features

• Git-based — Full Git feature set for dotfiles
• Alternative files — Per-machine, per-OS, per-host configs with ## suffix syntax
• Templates — Jinja2 template processing for dynamic configs
• Encryption — Private data via GPG, OpenSSL, transcrypt, or git-crypt
• Bootstrap — Customizable first-time setup script
• Hooks — Before/after hook support for any operation
• Portable — Single file, no dependencies beyond Git and Bash