Installation (OSX)

1. Install Homebrew

# install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

# uninstall (if needed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

2. Clone repo

git clone git@github.com:oshikryu/dotfiles.git ~/.dot

3. Run the init script

This installs brew dependencies, switches to zsh, creates symlinks, sets up neovim with lazy.nvim, and installs language servers.

./init_osx

The script will optionally prompt to install the legacy vim-plug config.

Neovim

Plugins are managed by lazy.nvim and configured in init.lua. Plugins install automatically on first launch.

• Update plugins: :Lazy update
• Sync plugins: :Lazy sync

LSP

Language servers are installed by the init script via yarn:

yarn global add typescript typescript-language-server pyright prettier

Environment variables

Add env-specific or sensitive variables in ~/.env.local (created by the init script, not tracked by git):

touch ~/.env.local

SSH keys

1. Generate a key and add to the SSH agent:

ssh-keygen -t rsa -b 4096
ssh-add ~/.ssh/id_rsa

2. Copy ~/.ssh/id_rsa.pub and add to GitHub: https://docs.github.com/en/authentication/connecting-to-github-with-ssh

3. For OSX 10.12+, add to ~/.ssh/config:

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_rsa

Git

The gitconfig is symlinked. Update the email to match your environment:

git config --global user.email "ryushikiri@gmail.com"

Troubleshooting

tmux exits immediately on launch

brew install reattach-to-user-namespace

See: https://superuser.com/questions/397076/tmux-exits-with-exited-on-mac-os-x

zsh theme not updating

Make sure ~/.zshrc is properly symlinked to ~/.dot/zshrc.

colorscheme not found (legacy vim-plug only)

cp -r colors ~/.vim/