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を提供しています。$schemaプロパティはvibeが設定ファイルを保存する際に自動的に追加されます：

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

スキーマURLにはvibeのバージョンタグ（例：v0.10.0）が含まれ、インストールされているバージョンとの互換性が保証されます。

スキーマバージョニング

アップグレード時の動作:

vibeをアップグレードすると、$schema URLは自動的に新しいバージョンに更新されます
古いスキーマURLはGitHub上で引き続きアクセス可能なため、既存の設定ファイルは動作し続けます
スキーマはメジャーバージョン内で後方互換性があります

VS Code設定

VS Codeは$schemaプロパティがあると自動的に補完を提供します。手動で設定する場合は、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": []
  }
}