Skip to content
jordi9Public

About

Dotfiles my own way. Using antidote and homeshick

Resources

Stars

2 stars

Watchers

1 watching

Forks

Latest commit

 

History

382 Commits

Folders and files

Repository files navigation

dotfiles

Personal macOS configuration managed with Homeshick. Homeshick links files from home/ into ~. Antidote installs external Zsh plugins.

Install

Bootstrap Homebrew and GitHub access

Install Homebrew and add it to the current shell:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv)"

Install the tools needed to clone this repository. Bitwarden is installed early for convenience. The Brewfile installs it again harmlessly. Rex Beta, the terminal and multiplexer, has no Homebrew cask; download it manually.

brew install gh homeshick
brew install --cask bitwarden
gh auth login  # choose SSH to create and upload this Mac's key

Load Homeshick, clone the repository, and link it into ~:

export HOMESHICK_DIR=/opt/homebrew/opt/homeshick
source "$HOMESHICK_DIR/homeshick.sh"
homeshick clone git@github.com:jordi9/dotfiles.git
cd ~/.homesick/repos/dotfiles
homeshick link dotfiles

Install packages and runtimes

The Brewfile lists all Homebrew formulae, applications, and fonts. Mise installs the fallback runtimes and most registry-published CLI tools from ~/.config/mise/config.toml. Pi remains a pnpm global so pi update can update its executable. A project can override mise tools with its own mise.toml. init/mise.sh also installs the global Vite+ vp command, configured to use the mise-managed Node.js and pnpm.

./init/brew.sh
./init/mise.sh

Clone the internal source packages linked by pnpm and used by Pi settings:

mkdir -p ~/dev
jj git clone git@github.com:jordi9/chloe.git ~/dev/chloe
jj git clone git@github.com:jordi9/pi-dac.git ~/dev/pi-dac
jj git clone git@github.com:jordi9/pi-impeccable.git ~/dev/pi-impeccable

Finish the setup:

./init/pnpm.sh
./init/agents.sh
./init/zellij.sh
ya pkg install
./init/doctor.sh
exec zsh

init/pnpm.sh installs Pi with pnpm, then builds the internal packages before linking their commands. init/agents.sh installs Claude Code and Amp with their native installers, which keep them updated. init/zellij.sh verifies the pinned zjstatus download before replacing the plugin. init/doctor.sh reads the resulting setup and returns nonzero only for missing requirements.

Restore local configuration

Restore private castles, application preferences, and licenses from the private runbook. MonoLisa requires a separate license and is not in the Brewfile. Its absence produces a doctor warning.

Inspect the macOS preferences without changing them:

./init/macos.zsh

Apply the reviewed values with:

./init/macos.zsh --apply --wipe-dock

That command backs up the Dock preferences before erasing pinned applications. Grant Accessibility, Screen Recording, and login-item permissions in System Settings.

Zsh layout

home/.zshrc loads configuration in this order:

  1. Public Antidote plugins from ~/.zsh_plugins.txt.
  2. Personal modules: core.zsh, jj.zsh, navigation.zsh, git.zsh, and commands.zsh.
  3. Machine-specific plugins and configuration through machine-local.zsh.
  4. Environment, completion, autosuggestions, keybindings, and integrations.
  5. The prompt.

Atuin AI and history integration are enabled; its PTY proxy is disabled.

Put personal shell changes in the module that owns the concern:

  • core.zsh: locale, reload helpers, completion refresh, and native history
  • jj.zsh: jj workspace and wrapper behavior
  • navigation.zsh: directory helpers and ZLE navigation widgets
  • git.zsh: Git aliases and functions
  • commands.zsh: general command shortcuts
  • environment.zsh: PATH, terminal behavior, mise shims, and pnpm globals
  • integrations.zsh: mise, Carapace, Vite+, Atuin, direnv, and zoxide hooks
  • keybindings.zsh: widget registration and key bindings

Add public plugins to home/.zsh_plugins.txt. Antidote regenerates ~/.zsh_plugins.zsh when the manifest changes. The generated file is not tracked.

For machine-specific plugins, create ~/.zsh_plugins.local.txt. Each line can name a local checkout or remote repository:

$HOMESHICK_REPOS/my-private-dotfiles
git@github.com:company/zsh-tools

machine-local.zsh generates ~/.zsh_plugins.local.zsh and loads it after the personal modules, so private definitions win. When the manifest is absent, the loader ignores any stale generated file.

For arbitrary machine-specific shell configuration, create ~/.zshrc.local. The same loader sources it after the private plugins. This file is not tracked.

Private configuration and licenses belong in separate castles. Keep their names and setup instructions in the private runbook:

homeshick clone <private-castle-url>
homeshick link <castle-name>

Daily use

dot       # cd ~/.homesick/repos/dotfiles
reload    # source ~/.zshrc

Run homeshick link dotfiles after adding a tracked file. Use reload for shell module changes. Restart the shell after changing an Antidote manifest.

If imported Moom or Manytricks settings do not appear, run killall cfprefsd. Some hotkeys follow Rectangle.

This setup borrows ideas from mathiasbynens/dotfiles, getantidote/zdotdir, maximbaz/dotfiles, and paulirish/dotfiles.

About

Dotfiles my own way. Using antidote and homeshick

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages