Feiyou's dotfiles

• Usage
• License

The structure of this repository is inspired by Alex Pearce and Abdullah Khabir.

Usage

1. Install Homebrew

   • Don't forget to add eval "$(/opt/homebrew/bin/brew shellenv) to your $HOME/.zshrc

2. Clone this repository into your $HOME folder.

   $ git clone git@github.com:gfeiyou/dotfiles.git $HOME/.dotfiles
   $ cd $HOME/.dotfiles

3. Install tools from Brewfile (stow, tmux, nvim, ...)

   brew bundle

   This also installs the fonts: Victor Mono and the Nerd Fonts v3 Symbols Nerd Font (icons for nvim/tmux via terminal font fallback). Restart the terminal afterwards. Keep icon glyphs on Nerd Fonts v3 codepoints (brew install nerdfix && nerdfix check -r <path> finds obsolete ones).

4. Stow needed config

   stow wezterm nvim tmux ...

5. (opencode) Install agent skills & tools:

   ~/.config/opencode/scripts/sync-skills.sh

   This installs (all globally, nothing written into the repo):

   • skills listed in opencode/.config/opencode/skills-lock.json → ~/.agents/skills/ (private sources need GitHub SSH access)
   • OpenSpec skills and /opsx:* commands → ~/.config/opencode/{skills,commands}/ (git-ignored). Re-run the script after brew upgrade openspec. In a new project, run openspec init --tools none once to create openspec/.
   • Plannotator binary and /plannotator-* commands (the plan-review plugin itself is set in opencode.json)

   To add a skill, record it in the lock, then sync:

   cd ~/.config/opencode
   npx skills add <owner/repo> --skill <name> -a opencode -y   # updates skills-lock.json
   ./scripts/sync-skills.sh

   To remove one, delete its entry from skills-lock.json and rm -rf ~/.agents/skills/<name>.

6. Restart zsh, zinit and zsh plugins will be installed automatically.

7. Start nvim, plugins, lsps, and treesitters will be installed automatically.

8. Start tmux, tpm and plugins will be installed automatically.

License

MIT.