Make every Linux & macOS box feel like home.

#

Homie is a single binary that turns a fresh Linux or macOS install into your install — dotfiles, packages, setup scripts, all from one repo you own. One command from a bare box to a working environment:

curl -fsSL https://raw.githubusercontent.com/USERNAME/dotfiles/main/bootstrap.sh | bash

That’s it! That’s the whole setup story.

Get started

#

1. Install hm:

   curl -fsSL https://homie.sh/install.sh | bash

2. hm init ~/dotfiles to scaffold a starter repo.
3. Edit homie.toml, commit, and push to your preferred git hosting service.
4. On any other Linux or macOS box: curl …/bootstrap.sh | bash.

Read the quickstart →

What you get

#

• Symlinks, not copies. Edit ~/.zshrc and you’re editing the file in your repo. git diff shows what changed. No chezmoi edit indirection.
• One repo, three jobs. Dotfiles + system packages + setup scripts, declared in one homie.toml. No glue between separate tools.
• No state file. Every hm apply is a full reconciliation. Idempotent by construction — re-running is always safe.
• Static binary. No Python, no Ruby, no daemon. ~3 MB, single file.
• Charm-powered TUI. Spinners, progress, a friendly summary at the end. Plain output in CI.

How it looks

#

# homie.toml
[user]
name  = "Scout Homes"
email = "scout@homie.sh"

[profile]
name          = "personal"
default_shell = "zsh"

[packages]
all    = ["git", "zsh", "neovim", "tmux", "ripgrep", "fd", "fzf"]
fedora = ["util-linux-user"]
ubuntu = ["fd-find"]

[vars]
EDITOR = "nvim"

dotfiles/             ← your repo (call it whatever you like)
  homie.toml
  bootstrap.sh
  home/               ← files into $HOME — .tmpl renders, the rest symlinks
    .zshrc
    .gitconfig.tmpl
  scripts/            ← ordered setup steps
    01-shell.sh
    02-tools.sh

Why not just…?

#

See the full comparison →