# andsens/homeshick

git dotfiles synchronizer written in bash

Repository: https://github.com/andsens/homeshick
Canonical: https://ross.abutalabs.com/products/homeshick
Language: Shell
License: MIT
License Family: permissive
Topics: dotfile-manager, bash, git
Last push: 2026-07-10T16:15:43+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 8, longevity 100
- inputs: {"age_days": 5257, "days_push": 54, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2193, forks 146 (observed 2026-08-28T04:06:24.996982+00:00)

## What it is
homeshick is a dotfiles synchronizer written in Bash that uses git to manage and deploy configuration files across machines. It clones dotfile repositories and symlinks their contents into your home directory, requiring only Bash 3 and Git 1.5.

## Use cases
- sync my dotfiles across multiple machines
- manage vim and zsh configs with git
- set up my shell environment on a new server
- install oh-my-zsh and plugins via dotfile repos
- symlink config files from a git repository
- back up and restore unix configuration files

## When to choose
- you want a dependency-free dotfile manager that only needs bash and git
- you need to manage multiple dotfile repositories including frameworks like oh-my-zsh
- you work on bare-bones remote machines without root privileges
- you prefer a simple symlink-based approach over full-file copying

## When to avoid
- you need a dotfile manager with templating or secret management features
- you want a GUI or rich CLI with many built-in commands
- you are on Windows without a POSIX shell environment
- you prefer tools written in a higher-level language with plugin ecosystems

## Facets
- artifact type: cli-tool
- maturity: stable
- function: version-control, developer-tools, file-system, configuration-management
- domain: developer-tools, version-control
- platform: bsd, cli
- tags: dotfiles, bash, git, symlinks, homesick, command-line, automation, linux, macos

## Member repositories
- andsens/homeshick (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:24.996982+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:47:18.393436+00:00, confidence not recorded.
  - readme: https://github.com/andsens/homeshick (fetched 2026-08-28T04:06:24.996982+00:00, sha 0d1cb4d78a41)
- Data as of 2026-08-30T08:39:29.467469+00:00.