# technicalpickles/homesick

Your home directory is your castle. Don't leave your dotfiles behind.

Repository: https://github.com/technicalpickles/homesick
Canonical: https://ross.abutalabs.com/products/homesick
Language: Ruby
License: MIT
License Family: permissive
Last push: 2026-07-17T23:04:13+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 43, longevity 100
- inputs: {"age_days": 6026, "days_push": 47, "days_rel": 164, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2452, forks 128 (observed 2026-08-28T04:06:52.977918+00:00)

## What it is
Homesick is a Ruby CLI tool for managing dotfiles using git. It clones dotfile repositories ('castles') into ~/.homesick and symlinks their contents into your home directory with a single command.

## Use cases
- manage my dotfiles with git
- symlink config files into home directory
- sync shell and vim configs across machines
- clone and install someone's dotfiles repo
- track new config files into a dotfiles repo

## When to choose
- you want git-based dotfile management with simple symlink deployment
- you want to share or reuse dotfile repos across machines
- you want optional per-repo setup scripts (.homesickrc)

## When to avoid
- you need a cross-language tool or don't use Ruby
- you prefer declarative dotfile managers like GNU Stow or Nix home-manager
- you want encrypted or secret-managed dotfiles out of the box

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, configuration-management, file-system, cli
- domain: developer-tools
- platform: cli, ruby
- tags: dotfiles, symlink-manager, git-based, ruby-gem, home-directory, command-line, automation, linux, macos

## Member repositories
- technicalpickles/homesick (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:52.977918+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:30:11.003682+00:00, confidence not recorded.
  - readme: https://github.com/technicalpickles/homesick (fetched 2026-08-28T04:06:52.977918+00:00, sha 6592e3c141fd)
- Data as of 2026-08-30T08:39:29.467469+00:00.