heyitsiveen
交互式命令行设置macOS和Windows 11的dotfiles。一个安装、主题化、备份和管理开发环境的命令。
目录表
快速入门
pnpm dlx @heyitsiveen/dotfiles@latest
或与其他包运行程序：
npx @heyitsiveen/dotfiles@latest
bunx @heyitsiveen/dotfiles@latest
yarn dlx @heyitsiveen/dotfiles@latest
该命令修改主目录。 它写入到
~/.config/（macOS上的Fish配置）或PowerShell配置文件（Windows），以及其他特定于工具的路径。 现有配置备份到~/.config/heyitsiveen/dotfiles/backup/在任何覆盖之前。 预览与--dry-run第一。撤销与--restore或者--uninstall.
先决条件
| 先决条件 | 为什么 | 安装 |
|---|---|---|
| Node.js >= 22 | 运行CLI | pnpm runtime set node lts -g， brew install node，或者 nodejs.org |
| 书呆子的字体 | 汰渍的图标，哦，我的时髦，Neovim | nerdfonts.com （推荐：JetBrains Mono NF） |
| 家酿 (macOS) / winget (窗口) | 安装工具 | brew.sh /预安装在Windows 11上 |
工具
命令行会自动检测所有工具，并提供通过Homebrew （macOS）或winget （Windows）安装缺失的工具。
要求 （dotfiles的核心工具）：
| 工具 | macOS | 窗户 |
|---|---|---|
| Git | brew install git | winget install Git.Git |
| 鱼壳/ PowerShell | brew install fish | winget install Microsoft.PowerShell |
| 鬼/ WezTerm | brew install --cask ghostty | winget install wez.wezterm |
| Neovim | brew install neovim | winget install Neovim.Neovim |
| tree-sitter-cli | brew install tree-sitter-cli | pnpm add -g tree-sitter-cli (或 npm i -g tree-sitter-cli） |
| C编译器 | xcode-select --install | VS构建工具 |
注意： 只有在安装Neovim时才需要tree-sit -cli和C编译器。LazyVim使用它们来编译语法解析器。macOS通常通过Xcode命令行工具预先安装了C编译器。
可选 （提升体验）：
| 工具 | macOS | 窗户 |
|---|---|---|
| tmux | brew install tmux | N/A |
| 蝙蝠 | brew install bat | winget install sharkdp.bat |
| btop | brew install btop | winget install aristocratos.btop4win |
| ripgrep | brew install ripgrep | winget install BurntSushi.ripgrep.MSVC |
| fd | brew install fd | winget install sharkdp.fd |
| eza | brew install eza | winget install eza-community.eza |
| fastfetch | brew install fastfetch | winget install Fastfetch-cli.Fastfetch |
| oh-my-posh | N/A | winget install JanDeDobbeleer.OhMyPosh |
包括什么
macOS
| 工具 | 描述 |
|---|---|
| 鱼壳 | config.fish， 9个conf.d模块，8个函数，3个Tide调色板主题 |
| Ghostty | 终端模拟器与JetBrains单声道，0.9不透明度，3个主题 |
| WezTerm | 具有Solarized/Vercel/Vesper配色方案的跨平台终端 |
| tmux | 7个配置文件（主，键绑定，状态栏，窗格，通知，弹出） |
| Neovim | LazyVim与solizzed -osaka， Snacks, Mason (oxfmt + oxlint)，符合 |
| 蝙蝠 | 配置+ Vercel/Vesper自定义。tmTheme主题 |
| btop | 系统监视器+ 3个主题文件 |
| ripgrep | 智能案例，隐藏文件，常见排除 |
| 克劳德代码 | 6台MCP服务器，克劳德。医学博士,设置 |
窗户
| 工具 | 描述 |
|---|---|
| PowerShell | 简介，5个模块，3个功能 |
| oh-my-posh | 3个TOML提示主题（Solarized, Vercel, Vesper） |
| WezTerm | windows适应的配置选项卡栏 |
| Neovim | LazyVim（与macOS相同的配置） |
| 蝙蝠 | 配置+自定义主题 |
| btop | 系统监视器+ 3个主题文件 |
| ripgrep | 搜索配置 |
| 克劳德代码 | 6台MCP服务器，克劳德。医学博士,设置 |
⚠️ Claude Code配置是作者的个人设置。
settings.json启用特定的插件，设置effortLevel: xhigh，advisorModel: opus，并跳过危险模式权限提示。.claude.json连接三台MCP服务器（exa, grep, better-auth）。CLAUDE.md是作者的13条规则指令集。如果你喜欢默认设置， 取消选择“克劳德代码” 当命令行询问要安装或替换哪个配置中的文件时~/.claude/后安装。
颜色主题
所有工具都有三个主题：
| 主题 | 风格 |
|---|---|
| 过度曝光黑暗 | 温暖，低对比度的暗主题（默认） |
| Vercel | 最小，高对比度的黑暗主题 |
| 黄昏的 | 柔和，温暖的深色主题与橙色口音 |
在所有已安装的工具中立即切换主题：
pnpm dlx @heyitsiveen/dotfiles --theme vercel
pnpm dlx @heyitsiveen/dotfiles --theme vesper
pnpm dlx @heyitsiveen/dotfiles --theme solarized-dark
CLI旗帜
| 国旗 | 描述 |
|---|---|
--platform <macos|windows> | 跳过操作系统检测 |
--dry-run | 显示未写入文件的计划操作 |
--theme <name> | 切换主题: solarized-dark， vercel， vesper |
--restore | 从备份恢复 |
--uninstall | 删除已安装的dotfiles |
--version | 显示版本 |
--help | 显示使用 |
它是如何工作的
- 检测您的操作系统（macOS或Windows）
- 检查缺失的工具并提供安装（brew/winget）
- 显示可用的dotfile配置
- 选择要安装的配置
- 你选择一个颜色主题
- 备份现有的dotfiles（可选- Neovim备份包括LazyVim插件数据）
- 将配置复制到正确的位置
- 在所有工具中激活您选择的主题
- 检查更新并在有新版本可用时通知您
后续运行检测现有安装并提供：
- 全新安装 - backup + overwrite
- 更新 -应用新版本包的更改
- 改变主题 -在所有工具之间切换颜色
- 卸载 -删除配置，卸载工具（brew/winget），或两者兼而有之
- 恢复 -从每个工具带时间戳的备份中恢复
开发
这个回购使用 规划． 看到 文档/ pnpm-setup.md 如果你不知道 拥有它——你不需要先安装Node， pnpm自带。
# Install dependencies (Node is fetched automatically per devEngines.runtime)
pnpm install
# Build
pnpm run build
# Run locally
node dist/index.mjs
# Run all checks (typecheck + lint + format)
pnpm run check
# Previously (replaced by pnpm — kept for reference):
# npm install && npm run build && npm run check
# bun install && bun run build && bun run check
导向钩子 都是通过 沙哑的 + lint-staged． 每一个 git commit 自动:
- 格式上演
.ts带有oxfmt的文件 - 绑带上演
.ts带有oxlint的文件 - 使用tsc对项目进行类型检查
许可证
麻省理工学院