youhide / hideDot

🚀 A blazing fast dotfiles manager in Go - Manage your dotfiles, symlinks, and system configuration with a simple YAML config. Features home directory expansion, git repo cloning, and shell command execution.

hideDot

A blazing fast dotFiles manager written in Go. Easily manage your dotfiles, symlinks, and system configuration with a simple YAML config.

Features

• 🚀 Fast symlink management
• 🏠 Home directory path expansion (~/)
• 🔄 Git repository cloning
• 🛠️ Shell command execution
• 🔍 Duplicate symlink detection
• 🧪 Dry-run mode

Installation

brew tap youhide/homebrew-youhide
brew install hidedot

Usage

1. Create hidedot.conf.yaml:

- defaults:
    link:
      relink: true
      force: true
  
  # Create directories
  create:
    - ~/.config
    - ~/.local/bin
  
  # Manage symlinks
  link:
    ~/.config/nvim: ~/.mydotfiles/nvim
    ~/.zshrc: ~/.mydotfiles/zsh/zshrc
  
  # Clone git repositories
  git:
    ~/.oh-my-zsh:
      url: https://github.com/ohmyzsh/ohmyzsh.git
      description: "Oh My Zsh"

  # Run shell commands
  shell:
    - [touch ~/.hushlogin, Create hushlogin]

2. Run HideDot:

hidedot --config path/to/hidedot.conf.yaml

Options

• --dry-run: Show what would be done without making changes
• --config: Specify config file path (default: hidedot.conf.yaml)

Documentation

For detailed documentation, check out our Wiki.

License

MIT License