dotme: Instantly Apply Dotfiles from Any Git Repository with One CLI Command

Vinícius Rodrigues — Sat, 05 Apr 2025 19:49:58 +0000

🚀 Introducing `dotme`: A Tiny CLI to Apply Dotfiles from Any Git Repo

When starting a new project, I often find myself copying over the same dotfiles — things like .vscode/, .editorconfig, or .prettierrc. It's a small step, but it adds friction. So I built a CLI tool to automate it.

Meet dotme — a simple, cross-platform command-line utility that applies dotfiles from any Git repository directly into your current working directory.

✨ What Is `dotme`?

dotme is a small utility written in Go that clones a Git repository and copies only the files and folders from the root that start with a dot (.) into your current folder.

💡 Example use case: You maintain a personal dotfiles repo on GitHub with folders like .vscode, .editorconfig, and .prettierrc. With dotme, you can apply those settings to a new project instantly:

dotme https://github.com/your-user/dotfiles

🔧 Features

✅ Apply dotfiles from any Git repo with one command
🕵️ Only files and folders starting with a . are copied
📁 Dotfolders are copied recursively, even if inner files don’t start with .
🧼 Temporary clone directories are cleaned up automatically
🖥️ Cross-platform (Linux, macOS, Windows)
🧾 Terminal output shows exactly what was copied or ignored

📦 Installation

You can download the latest binary for your system from the releases page.

On Linux / macOS:

curl -L https://github.com/rsvinicius/dotme/releases/download/v0.1.0/dotme-linux-amd64 -o dotme
chmod +x dotme
sudo mv dotme /usr/local/bin/

On Windows:

Download dotme-windows-amd64.exe
Rename it to dotme.exe (optional)
Add it to your PATH

Or you can build from source:

git clone https://github.com/rsvinicius/dotme.git
cd dotme
go build -o dotme

⚙️ How It Works

Under the hood, dotme does the following:

Clones the specified Git repo into a temp directory
Filters the root directory for files/folders starting with .
Recursively copies those items into your current working directory
Prints a summary of actions (copied/ignored)
Cleans everything up

That’s it. No magic. No dependencies.

📓 Changelog

v0.1.0 – April 4, 2025

✅ Initial release
🛠️ CLI built using Cobra
🧹 Temporary directory cleanup
🧪 Basic filtering and copying logic
📚 Complete documentation, license, contribution guide
🖥️ Works on Linux, macOS, and Windows

See full changelog → CHANGELOG.md

🤝 Open Source & Contributions Welcome!

dotme is open source under the MIT License. I'm maintaining the project in public and welcoming ideas, contributions, bug reports, and feedback!

✅ Well-documented
🔖 Uses semantic versioning
📚 Has CONTRIBUTING.md, CHANGELOG.md, and MAINTAINING.md

If you like the idea, I’d love your help shaping it! Even opening an issue with feedback is already awesome. 🙏

→ GitHub: rsvinicius/dotme

🙌 Thanks for Reading!

I built this tool to scratch my own itch, but I believe it can help others streamline their dev workflow too. Give it a try, and let me know what you think!

→ Download dotme

→ Star the repo if you find it useful ❤️

DEV Community: Vinícius Rodrigues