Home

dotfiles Wiki

個人 macOS / Linux dotfiles,涵蓋 Neovim、Zsh、tmux、Hammerspoon 等終端機自動化、shell 設定與開發者生產力工具。

簡介

本 repo 採 topic-per-directory 佈局:每個工具一個目錄,任何名為 *.symlink 的檔案或目錄會由 start/link_dotfiles 連結到 $HOME 下的 .<name>。

例如:

• zsh/zshrc.symlink → ~/.zshrc
• claude.symlink → ~/.claude(整個目錄)
• config.symlink → ~/.config(約 90 個應用程式設定)

目錄地圖

路徑	說明
start/	安裝器:bootstrap、install、link_dotfiles、setup_linux.sh,共用 TUI 在 start/lib/
zsh/	模組化 zsh 設定,外掛延遲載入
claude.symlink/	~/.claude — 全域 Claude 設定、45+ skills、hooks(大部分被 gitignore,僅白名單路徑追蹤)
claude.symlink/go-tools/	claude-hooks 與 claude-statusline 二進位檔的 Go 原始碼
config.symlink/	~/.config — nvim(NvChad v2.5 + lazy.nvim)、wezterm、kitty、helix、yazi 等
neovim/	舊版 NvChad-custom 設定(2.5 之前),僅供參考,不再連結
hammerspoon.symlink/	Hammerspoon:hyper key、vim mode、視窗管理
tmux/	tmux.conf + TPM 外掛(外掛本體被 gitignore)
git/	gitconfig(delta pager、difftastic、GPG 簽章)、全域 ignore
bin/	dot(macOS 相依安裝)、toggle-theme(明暗主題切換)
shellscripts/	約 70 個 bash 工具,經 zprofile 加入 PATH
pyscripts.symlink/	約 47 個 Python 工具(~/pyscripts,在 PATH 上)
osx/	set-defaults.sh — macOS defaults write 設定
system/	早期載入的 zsh env / path 片段
docs/	Quarto book,透過 Netlify 部署
Brewfile	Homebrew bundle(約 370 formulae、250 casks)

快速開始

git clone https://github.com/htlin222/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
start/bootstrap      # 全新機器:安裝相依 + 連結
start/link_dotfiles  # 僅重新連結 symlink

頁面導覽

• Maintenance — 日常維護流程與慣例
• Roadmap — 發展路線圖
• Plan-and-Tech-Debt — 計畫與技術債