Moshe Avni's DotFiles

Table of Contents

• Usage
• Usage (just NVIM)
• Additional stuff
• GitHub notifications on macOS
• Troubleshooting
  • Remove TreeSitter parsers

Repository layout and file-placement conventions are documented in CLAUDE.md (Architecture ▸ Stow Package Structure).

Usage

(also, how to bootstrap a brand new Mac laptop)

0. Install xcode-select (for basically everything…)

   xcode-select --install

1. Install Homebrew

   /bin/bash -c \
     "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   eval "$(/opt/homebrew/bin/brew shellenv)" # to make brew available before we load `~/.zshrc` that has "$PATH"
   brew update
   brew install git stow

2. Clone this repository:

   [[ -d ~/Repos ]] || mkdir ~/Repos
   cd ~ && git clone git@github.com:mosheavni/dotfiles.git .dotfiles && cd .dotfiles

3. Install antidote

   git clone --depth=1 https://github.com/mattmc3/antidote.git ${ZDOTDIR:-~}/.antidote

4. Stow the .dotfiles and reload the shell:

   ./start.sh
   source ~/.zshrc

5. Install and update everything (brew, asdf, pip, npm, etc.):

   ./updates.sh

6. Open Wezterm and start using a real terminal.

7. ???

8. PROFIT

Usage (just NVIM)

Install requires Neovim 0.10+. Always review the code before installing a configuration.

Clone the repository and install the plugins:

git clone git@github.com:mosheavni/dotfiles ~/.config/mosheavni/dotfiles

Open Neovim with this config:

NVIM_APPNAME=mosheavni/dotfiles/nvim/.config/nvim nvim

Additional stuff

• Adjust dock and keyboard settings

• Download and install Docker

• Change clipy (for snippets) and maccy (for clipboard) shortcuts, and load snippets

• Mac App Store apps (Magnet, OneNote) install via brew bundle — sign into the App Store first

AI / Claude Code Skills

Claude Code skills extend the /skill-name slash command system. Skills live in ~/.claude/skills/.

./ai/install-skills.sh

Verify with npx skills ls -g.

GitHub notifications on macOS

Native macOS notifications for unread GitHub notifications, polled every 60s by a launchd agent. Lives in the automations stow package (.local/bin/gh-notify.sh plus the agent plist).

One-time setup on a new machine (after ./start.sh and ./updates.sh):

gh-notify-setup.sh

The script is interactive (uses gum) and idempotent — it installs any missing deps (gh, terminal-notifier, gum), ensures the stow symlinks, checks gh auth + token scope, (re)loads the launchd agent, and fires a test banner. Safe to re-run anytime.

If no banner appears, allow it under System Settings ▸ Notifications ▸ terminal-notifier (style: Alerts/Banners).

Manage the agent:

launchctl bootout   gui/$(id -u)/com.mosheavni.ghnotify                                # pause
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.mosheavni.ghnotify.plist   # resume
~/.local/bin/gh-notify.sh                                                              # run once
tail -f ~/.cache/gh-notify/error.log                                                   # debug

Troubleshooting

Reinstalling all packages

Run ./updates.sh — it handles brew, asdf, pip, npm, GitHub releases, and build-from-source tools.

Remove TreeSitter parsers

rm -rf ~/.local/share/nvim/treesitter

Then reopen nvim and run :TSUpdate