settings.json

settings.json 文件包含保存在本地、不与团队共享的用户级设置。该文件位于 ~/.config/vibe/settings.json。

位置

平台	路径
macOS	`~/.config/vibe/settings.json`
Linux	`~/.config/vibe/settings.json`
Windows	`%USERPROFILE%\.config\vibe\settings.json`

配置项

快速删除（Clean 性能）

默认情况下，vibe 会使用快速删除策略：先将 worktree 目录移动到临时位置，再在后台异步删除。这使得即便是大型仓库，vibe clean 也能瞬间完成。

{
  "version": 3,
  "clean": {
    "fast_remove": true
  }
}

选项	默认值	说明
`fast_remove`	`true`	使用快速异步删除（移动 + 后台删除）

工作原理：

worktree 目录会被瞬间重命名为隐藏的 .vibe-trash-* 目录（O(1) 操作）
针对已清空的目录清理 git worktree 元数据
实际的文件删除在后台异步执行
之前遗留的 .vibe-trash-* 目录会被自动清理

Worktree 路径脚本

使用自定义脚本覆盖默认的 worktree 路径：

{
  "version": 3,
  "worktree": {
    "path_script": "~/.config/vibe/worktree-path.sh"
  }
}

跳过哈希校验

全局禁用哈希校验（不推荐）：

{
  "version": 3,
  "skipHashCheck": true
}

JSON Schema

vibe 提供了用于编辑器自动补全和校验的 JSON Schema。当 vibe 保存设置文件时，会自动添加 $schema 属性：

{
  "$schema": "https://raw.githubusercontent.com/kexi/vibe/v0.10.0/schemas/settings.schema.json",
  "version": 3,
  "clean": {
    "fast_remove": true
  }
}

Schema URL 中包含 vibe 的版本标签（例如 v0.10.0），以确保与你所安装的版本兼容。

Schema 版本管理

升级时的行为：

升级 vibe 后，$schema URL 会自动更新为对应的新版本
旧的 Schema URL 在 GitHub 上依然可以访问，因此已有的设置文件仍能正常工作
Schema 在同一主版本内保持向后兼容

VS Code 设置

只要存在 $schema 属性，VS Code 就会自动提供补全。如需手动配置，请在 VS Code 设置中添加：

{
  "json.schemas": [
    {
      "fileMatch": ["**/vibe/settings.json"],
      "url": "https://raw.githubusercontent.com/kexi/vibe/v0.10.0/schemas/settings.schema.json"
    }
  ]
}

请将 v0.10.0 替换为你已安装的 vibe 版本。

完整示例

{
  "$schema": "https://raw.githubusercontent.com/kexi/vibe/v0.10.0/schemas/settings.schema.json",
  "version": 3,
  "skipHashCheck": false,
  "worktree": {
    "path_script": "~/.config/vibe/worktree-path.sh"
  },
  "clean": {
    "fast_remove": true
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}