{"id":35136638,"url":"https://github.com/kexi/vibe","last_synced_at":"2026-05-23T04:01:39.570Z","repository":{"id":330788412,"uuid":"1123923867","full_name":"kexi/vibe","owner":"kexi","description":"Super fast Git worktree management tool with Copy-on-Write optimization","archived":false,"fork":false,"pushed_at":"2026-05-12T08:00:52.000Z","size":2361,"stargazers_count":21,"open_issues_count":13,"forks_count":4,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2026-05-12T09:37:59.507Z","etag":null,"topics":["cli","developer-tools","git","typescript","worktree"],"latest_commit_sha":null,"homepage":"https://vibe.kexi.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kexi.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY_CHECKLIST.ja.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"kexi"}},"created_at":"2025-12-27T23:31:03.000Z","updated_at":"2026-05-12T07:57:01.000Z","dependencies_parsed_at":"2026-01-31T20:08:28.089Z","dependency_job_id":null,"html_url":"https://github.com/kexi/vibe","commit_stats":null,"previous_names":["kexi/vibe"],"tags_count":147,"template":false,"template_full_name":null,"purl":"pkg:github/kexi/vibe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kexi%2Fvibe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kexi%2Fvibe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kexi%2Fvibe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kexi%2Fvibe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kexi","download_url":"https://codeload.github.com/kexi/vibe/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kexi%2Fvibe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33085510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","developer-tools","git","typescript","worktree"],"created_at":"2025-12-28T09:31:20.706Z","updated_at":"2026-05-16T00:21:24.739Z","avatar_url":"https://github.com/kexi.png","language":"TypeScript","funding_links":["https://github.com/sponsors/kexi"],"categories":[],"sub_categories":[],"readme":"# vibe\n\nGit Worktreeを簡単かつ超高速に管理するCLIツール。\n\n[English](README.md)\n\n## ドキュメント\n\n📚 完全なドキュメントは [vibe.kexi.dev](https://vibe.kexi.dev) で閲覧できます\n\n## 使い方\n\n| コマンド                           | 説明                                                                     |\n| ---------------------------------- | ------------------------------------------------------------------------ |\n| `vibe start \u003cbranch\u003e [options]`    | 新規または既存ブランチでworktreeを作成（冪等）                           |\n| `vibe scratch [options]`           | `scratch/\u003ctimestamp\u003e` 形式の自動命名 worktree を作成                     |\n| `vibe jump \u003cbranch\u003e [options]`     | ブランチ名で既存のworktreeにジャンプ（部分一致・ファジーマッチ対応）     |\n| `vibe rename \u003cnew-name\u003e [options]` | 現在の worktree のブランチとディレクトリをリネーム                       |\n| `vibe clean [options]`             | 現在のworktreeを削除してメインに戻る（未コミットの変更がある場合は確認） |\n| `vibe home`                        | Worktreeを削除せずにメインに戻る                                         |\n| `vibe trust`                       | `.vibe.toml`と`.vibe.local.toml`ファイルを信頼登録                       |\n| `vibe untrust`                     | `.vibe.toml`と`.vibe.local.toml`ファイルの信頼を解除                     |\n| `vibe verify`                      | 信頼ステータスとハッシュ履歴を検証                                       |\n| `vibe config`                      | 現在の設定を表示                                                         |\n| `vibe upgrade [options]`           | アップデートを確認しアップグレード方法を表示                             |\n\n### 例\n\n```bash\n# 新しいブランチでworktreeを作成\nvibe start feat/new-feature\n\n# 既存ブランチを使用（またはworktreeが既に存在する場合も再実行可能）\nvibe start feat/existing-branch\n\n# 特定のブランチをベースにworktreeを作成\nvibe start feat/new-feature --base main\n\n# 既存のworktreeにジャンプ（完全一致、部分一致、ファジーマッチ）\nvibe jump feat/new-feature\nvibe jump login\nvibe jump feli  # \"feat/login\" にファジーマッチ\n\n# 名前を考えずに scratch worktree を作成（自動命名: scratch/\u003ctimestamp\u003e）\nvibe scratch\n\n# 現在の scratch を正式名にリネーム（昇格）\nvibe rename my-feature\n\n# 作業完了後、worktreeを削除\nvibe clean\n\n# Worktreeを削除せずにメインに戻る\nvibe home\n```\n\n### インタラクティブプロンプト\n\n`vibe start`は以下の状況に対応します：\n\n- **ブランチが既に他のworktreeで使用中の場合**: 既存のworktreeに移動するか確認します\n- **同じworktreeが既に存在する場合**: 自動的に再利用します（冪等）\n- **異なるブランチのディレクトリが存在する場合**: 以下の選択肢から選べます\n  - 上書き（削除して再作成）\n  - 再利用（既存ディレクトリを使用）\n  - キャンセル\n\n```bash\n# ブランチが既に使用中の場合の例\n$ vibe start feat/new-feature\nブランチ 'feat/new-feature' は既にworktree '/path/to/repo-feat-new-feature' で使用中です。\n既存のworktreeに移動しますか? (Y/n)\n```\n\n### ベースブランチオプション\n\n`--base`オプションは新しいブランチの開始点を指定します：\n\n- **新規ブランチ**: 指定されたベース（ブランチ、タグ、またはコミット）からブランチを作成\n- **既存ブランチ**: `--base`オプションは警告と共に無視される\n- **無効なベース**: 指定された参照が存在しない場合はエラーで終了\n\nデフォルトでは、`--base`はupstreamトラッキングを**設定しません**。明示的にupstreamを設定するには`--track`を使用します：\n\n```bash\n# upstreamトラッキングなし（デフォルト）\nvibe start feat/new-feature --base origin/develop\n\n# upstreamトラッキングあり\nvibe start feat/new-feature --base origin/develop --track\n```\n\n### クリーンアップ動作\n\n`vibe clean` は、worktreeディレクトリを同期的に削除する代わりに移動する高速削除戦略を使用します：\n\n- **macOS**: Finderを通じてシステムのゴミ箱に移動（必要に応じて復元可能）\n- **Linux**: XDGゴミ箱に移動（ファイルマネージャーから復元可能）\n- **Windows**: 一時ディレクトリに移動し、バックグラウンドで削除\n\nこれにより、worktreeのサイズに関係なく `vibe clean` が即座に完了します。\n\n### グローバルオプション\n\n| オプション        | 説明                   |\n| ----------------- | ---------------------- |\n| `-h`, `--help`    | ヘルプメッセージを表示 |\n| `-v`, `--version` | バージョン情報を表示   |\n| `-V`, `--verbose` | 詳細な出力を表示       |\n| `-q`, `--quiet`   | 不要な出力を抑制       |\n\n### コマンドオプション\n\n#### Startオプション\n\n| オプション        | 説明                                        |\n| ----------------- | ------------------------------------------- |\n| `--base \u003cref\u003e`    | 新規ブランチのベースブランチ/コミットを指定 |\n| `--track`         | `--base`使用時にupstreamトラッキングを設定  |\n| `--no-hooks`      | pre-startおよびpost-startフックをスキップ   |\n| `--no-copy`       | ファイルとディレクトリのコピーをスキップ    |\n| `-n`, `--dry-run` | 変更を加えずに実行内容を表示                |\n\n#### Cleanオプション\n\n| オプション        | 説明                           |\n| ----------------- | ------------------------------ |\n| `-f`, `--force`   | 確認プロンプトをスキップ       |\n| `--delete-branch` | worktree削除後にブランチも削除 |\n| `--keep-branch`   | worktree削除後にブランチを保持 |\n\n#### Upgradeオプション\n\n| オプション | 説明                                               |\n| ---------- | -------------------------------------------------- |\n| `--check`  | アップグレード方法を表示せずにアップデートのみ確認 |\n\n## インストール\n\n### Homebrew (macOS)\n\n```bash\nbrew install kexi/tap/vibe\n```\n\n### Homebrew Beta (macOS)\n\n最新の開発版をテストする場合:\n\n```bash\nbrew install kexi/tap/vibe-beta\n```\n\n\u003e ⚠️ **警告**: ベータ版は`develop`ブランチからビルドされており、不安定な機能が含まれている可能性があります。テスト目的でのみ使用してください。\n\n### npm (Node.js 18+)\n\n```bash\n# グローバルインストール\nnpm install -g @kexi/vibe\n\n# またはnpxで直接実行\nnpx @kexi/vibe start feat/my-feature\n```\n\n\u003e 注意: npmパッケージにはmacOS (APFS)とLinux (Btrfs/XFS)で最適化されたCopy-on-Writeファイルクローニング用のオプショナルなネイティブバインディング（`@kexi/vibe-native`）が含まれています。利用可能な場合は自動的に使用されます。\n\n### Bun (1.2.0+)\n\n```bash\n# グローバルインストール\nbun add -g @kexi/vibe\n\n# またはbunxで直接実行\nbunx @kexi/vibe start feat/my-feature\n```\n\n\u003e 注意: BunはNode.jsと同じnpmパッケージを使用します。Copy-on-Writeファイルクローニング用のネイティブバインディングは利用可能な場合に自動的に使用されます。\n\n### Deno (2.0+)\n\n```bash\n# JSR経由でインストール\ndeno install -A --global jsr:@kexi/vibe\n\n# または直接実行\ndeno run -A jsr:@kexi/vibe start feat/my-feature\n```\n\n\u003e 注意: JSR配布にはDeno 2.0+が必要です。\n\n### mise\n\n`.mise.toml`に追加:\n\n```toml\n[plugins]\nvibe = \"https://github.com/kexi/mise-vibe\"\n\n[tools]\nvibe = \"latest\"\n```\n\nその後、インストール:\n\n```bash\nmise install\n```\n\n#### mise hooksでのシェル設定\n\n[`mise activate`](https://mise.jdx.dev/getting-started.html#activate-mise)を使用している場合、\n`[hooks]`を追加して[手動シェル設定](#セットアップ)をスキップできます:\n\n```toml\n[hooks]\nenter = 'eval \"$(vibe shell-setup)\"'\n```\n\n### Nix\n\n```bash\n# 直接実行（一時的）\nnix run github:kexi/vibe -- start feat/my-feature\n\n# 永続インストール\nnix profile install github:kexi/vibe\n```\n\n\u003e 注意: NixパッケージはGitHub Releasesのビルド済みバイナリをSHA-256ハッシュで検証してインストールします。\n\n### Linux\n\n\u003e **注意**: WSL2ユーザーは、使用しているディストリビューションに応じて以下のLinuxインストール方法を使用できます。\n\n#### Ubuntu/Debian (.debパッケージ)\n\n```bash\n# x64\ncurl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_amd64.deb\nsudo apt install ./vibe_amd64.deb\n\n# ARM64\ncurl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_arm64.deb\nsudo apt install ./vibe_arm64.deb\n\n# アンインストール\nsudo apt remove vibe\n```\n\n#### その他のLinuxディストリビューション\n\n```bash\n# x64\ncurl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-x64 -o vibe\nchmod +x vibe\nsudo mv vibe /usr/local/bin/\n\n# ARM64\ncurl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-arm64 -o vibe\nchmod +x vibe\nsudo mv vibe /usr/local/bin/\n```\n\n### Windows (PowerShell)\n\n```powershell\n# ダウンロード\nInvoke-WebRequest -Uri \"https://github.com/kexi/vibe/releases/latest/download/vibe-windows-x64.exe\" -OutFile \"$env:LOCALAPPDATA\\vibe.exe\"\n\n# PATHに追加（初回のみ）\n$path = [Environment]::GetEnvironmentVariable(\"Path\", \"User\")\n[Environment]::SetEnvironmentVariable(\"Path\", \"$path;$env:LOCALAPPDATA\", \"User\")\n```\n\n### 手動ビルド\n\n```bash\nbun build --compile --minify --outfile vibe main.ts\n```\n\n## セットアップ\n\nシェルに以下を追加:\n\n\u003cdetails\u003e\n\u003csummary\u003eZsh (.zshrc)\u003c/summary\u003e\n\n```bash\nvibe() { eval \"$(command vibe \"$@\")\" }\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eBash (.bashrc)\u003c/summary\u003e\n\n```bash\nvibe() { eval \"$(command vibe \"$@\")\"; }\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eFish (~/.config/fish/config.fish)\u003c/summary\u003e\n\n```fish\nfunction vibe\n    eval (command vibe $argv)\nend\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eNushell (~/.config/nushell/config.nu)\u003c/summary\u003e\n\n```nu\ndef --env vibe [...args] {\n    ^vibe ...$args | lines | each { |line| nu -c $line }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003ePowerShell ($PROFILE)\u003c/summary\u003e\n\n```powershell\nfunction vibe { Invoke-Expression (\u0026 vibe.exe $args) }\n```\n\n\u003c/details\u003e\n\n## 設定\n\n### .vibe.toml\n\nリポジトリルートに`.vibe.toml`ファイルを配置すると、`vibe start`時に自動実行されます。\nこのファイルは通常Gitにコミットされ、チームで共有されます。\n\n```toml\n# ファイルとディレクトリを元リポジトリからworktreeへコピー\n[copy]\nfiles = [\".env\"]\ndirs = [\"node_modules\", \".cache\"]\n\n# 実行するコマンド\n[hooks]\npre_start = [\"echo 'Worktreeを準備中...'\"]\npost_start = [\n  \"pnpm install\",\n  \"pnpm db:migrate\"\n]\npre_clean = [\"git stash\"]\npost_clean = [\"echo 'クリーンアップ完了'\"]\n```\n\n初回は`vibe trust`で信頼登録が必要です。\n\n#### Copy設定でのGlobパターン\n\n`files`配列はglobパターンに対応しており、柔軟なファイル選択が可能です：\n\n```toml\n[copy]\nfiles = [\n  \"*.env\",              # ルートディレクトリの全.envファイル\n  \"**/*.json\",          # 全JSONファイル（再帰的）\n  \"config/*.txt\",       # config/内の全.txtファイル\n  \".env.production\"     # 厳密なパスも引き続き利用可能\n]\n```\n\n**サポートされるパターン:**\n\n- `*` - `/`以外の任意の文字にマッチ\n- `**` - `/`を含む任意の文字にマッチ（再帰的）\n- `?` - 任意の1文字にマッチ\n- `[abc]` - ブラケット内の任意の文字にマッチ\n\n**注意:**\n\n- マッチしたファイルをコピーする際、ディレクトリ構造は保持されます\n- 再帰的パターン（`**/*`）は、大規模リポジトリでは処理に時間がかかる場合があります\n  - 可能な限り具体的なパターンを使用してください（例: `**/*.json`より`config/**/*.json`）\n  - パターン展開はworktree作成時に1回だけ実行され、コマンド実行毎ではありません\n\n#### ディレクトリコピー設定\n\n`dirs`配列でディレクトリ全体を再帰的にコピーできます：\n\n```toml\n[copy]\ndirs = [\n  \"node_modules\",      # 厳密なディレクトリパス\n  \".cache\",            # 隠しディレクトリ\n  \"packages/*\"         # 複数ディレクトリにマッチするGlobパターン\n]\n```\n\n**注意:**\n\n- ディレクトリは完全コピーされます（差分同期ではありません）\n- Globパターンはファイルパターンと同様に動作します\n- `node_modules`のような大きなディレクトリはコピーに時間がかかる場合があります\n\n#### コピーパフォーマンスの最適化\n\nVibeはシステムに応じて最適なコピー戦略を自動選択します:\n\n| 戦略            | 使用条件                                    | プラットフォーム |\n| --------------- | ------------------------------------------- | ---------------- |\n| Clone (CoW)     | APFSでのネイティブclonefile()               | macOS            |\n| Clone (reflink) | Btrfs/XFSでのディレクトリコピー             | Linux            |\n| rsync           | cloneが利用できない場合のディレクトリコピー | macOS/Linux      |\n| Standard        | ファイルコピー、またはフォールバック        | 全て             |\n\n**仕組み:**\n\n- **ファイルコピー**: 単一ファイルの最高パフォーマンスのため、常にネイティブの`copyFile()`を使用\n- **ディレクトリコピー**: 利用可能な最速の方法を自動使用:\n  - APFSを使用したmacOS: `@kexi/vibe-native`経由でネイティブの`clonefile()`システムコールを使用し、即座にCoWクローニング。ネイティブモジュールが利用できない場合は`cp -cR`にフォールバック\n  - Btrfs/XFSを使用したLinux: CoWクローニングに`cp --reflink=auto`を使用\n  - CoWが利用できない場合はrsyncまたは標準コピーにフォールバック\n\n**メリット:**\n\n- Copy-on-Writeは実際のデータではなくメタデータのみをコピーするため非常に高速\n- 設定不要 - 最適な戦略が自動検出されます\n- 自動フォールバックによりコピーは常に動作します\n\nコピー戦略と実装の詳細については、[コピー戦略](docs/specifications/copy-strategies.ja.md)を参照してください。\n\n### Worktreeパス設定\n\n外部スクリプトを使用してWorktreeディレクトリパスをカスタマイズできます：\n\n```toml\n[worktree]\npath_script = \"~/.config/vibe/worktree-path.sh\"\n```\n\nスクリプトは以下の環境変数を受け取り、絶対パスを出力する必要があります：\n\n| 環境変数                | 説明                                | 例                 |\n| ----------------------- | ----------------------------------- | ------------------ |\n| `VIBE_REPO_NAME`        | リポジトリ名                        | `my-project`       |\n| `VIBE_BRANCH_NAME`      | ブランチ名                          | `feat/new-feature` |\n| `VIBE_SANITIZED_BRANCH` | サニタイズ済みブランチ名（`/`→`-`） | `feat-new-feature` |\n| `VIBE_REPO_ROOT`        | リポジトリルートパス                | `/path/to/repo`    |\n\n**スクリプト例:**\n\n```bash\n#!/bin/bash\necho \"${HOME}/worktrees/${VIBE_REPO_NAME}-${VIBE_SANITIZED_BRANCH}\"\n```\n\n### エディタサポート (JSON Schema)\n\nVibeは`settings.json`用のJSON Schemaを提供しており、自動補完とバリデーションが利用できます。`$schema`プロパティはvibeが設定ファイルを保存する際に**自動的に追加**されます。最新のエディタ（VS Code、IntelliJなど）は自動的に補完を提供します。\n\nVS Codeの手動設定については、[settings.jsonドキュメント](https://vibe.kexi.dev/ja/configuration/settings/#json-schema)を参照してください。\n\n### セキュリティ: ハッシュ検証\n\nVibeは`.vibe.toml`と`.vibe.local.toml`ファイルの整合性をSHA-256ハッシュを使って自動的に検証します。これにより、設定ファイルへの不正な変更を防ぎます。\n\n#### 仕組み\n\n- `vibe trust`を実行すると、Vibeは設定ファイルのSHA-256ハッシュを計算して保存します\n- `vibe start`を実行すると、Vibeはハッシュをチェックしてファイルが変更されていないか検証します\n- ハッシュが一致しない場合、Vibeはエラーで終了し、再度`vibe trust`を実行するよう求めます\n\n#### ハッシュチェックのスキップ（開発用）\n\n設定ファイル（`~/.config/vibe/settings.json`）でハッシュ検証を無効化できます:\n\n**グローバル設定:**\n\n```json\n{\n  \"version\": 3,\n  \"skipHashCheck\": true,\n  \"permissions\": { \"allow\": [], \"deny\": [] }\n}\n```\n\n**ファイルごとの設定:**\n\n```json\n{\n  \"version\": 3,\n  \"permissions\": {\n    \"allow\": [\n      {\n        \"repoId\": {\n          \"remoteUrl\": \"github.com/user/repo\",\n          \"repoRoot\": \"/path/to/repo\"\n        },\n        \"relativePath\": \".vibe.toml\",\n        \"hashes\": [\"abc123...\"],\n        \"skipHashCheck\": true\n      }\n    ],\n    \"deny\": []\n  }\n}\n```\n\n\u003e **注意**: バージョン3ではリポジトリベースのトラスト識別を使用します。設定は初回ロード時にv2からv3へ自動移行されます。トラストは同じリポジトリのすべてのワークツリー間で共有されます。\n\n#### ブランチ切り替え\n\nVibeはファイルごとに複数のハッシュ（最大100個）を保存するため、各ブランチのバージョンを一度信頼すれば、ブランチを切り替えても再度信頼登録する必要はありません。\n\n#### セキュリティ上の考慮事項\n\ntrust機構は、信頼した設定ファイルが変更されていないことを検証します。ただし、以下の点に注意してください：\n\n- **trustは意思表示**: `vibe trust`を実行すると、設定ファイル（含まれるフックコマンドを含む）をレビューし承認したことを宣言することになります。\n- **フックは任意のコマンドを実行**: `hooks.pre_start`、`hooks.post_start`などで定義されたコマンドは、あなたのシェルで実行されます。Vibeはこれらのコマンドをサンドボックス化したり制限したりしません。\n- **信頼する前にレビュー**: 特に自分が管理していないリポジトリでは、`vibe trust`を実行する前に`.vibe.toml`と`.vibe.local.toml`ファイルを必ずレビューしてください。\n- **ハッシュ検証はマルウェア対策ではない**: ハッシュチェックは、既に信頼したファイルへの変更を検出するだけです。コマンド自体が安全かどうかは評価しません。\n\n### .vibe.local.toml\n\n`.vibe.local.toml`ファイルを作成すると、Gitにコミットされないローカル専用の設定上書きができます（自動的にgitignoreされます）。\n開発者固有の設定に便利です。\n\n```toml\n# 共有フックをローカルコマンドで上書き・拡張\n[hooks]\npost_start_prepend = [\"echo 'ローカルセットアップ開始'\"]\npost_start_append = [\"npm run dev\"]\n\n# コピーするファイルを上書き\n[copy]\nfiles = [\".env.local\", \".secrets\"]\n```\n\n### 設定のマージ\n\n`.vibe.toml`と`.vibe.local.toml`の両方が存在する場合：\n\n- **完全上書き**: フィールド名を直接使用（例: `post_start = [...]`）\n- **先頭に追加**: `_prepend`サフィックスを使用（例: `post_start_prepend = [...]`）\n- **末尾に追加**: `_append`サフィックスを使用（例: `post_start_append = [...]`）\n\n**例:**\n\n```toml\n# .vibe.toml（共有）\n[hooks]\npost_start = [\"npm install\", \"npm run build\"]\n\n# .vibe.local.toml（ローカル）\n[hooks]\npost_start_prepend = [\"echo 'ローカルセットアップ'\"]\npost_start_append = [\"npm run dev\"]\n\n# 結果: [\"echo 'ローカルセットアップ'\", \"npm install\", \"npm run build\", \"npm run dev\"]\n```\n\n### 利用可能なフック\n\n| フック       | 実行タイミング                           | 利用可能な環境変数                       |\n| ------------ | ---------------------------------------- | ---------------------------------------- |\n| `pre_start`  | worktree作成前                           | `VIBE_WORKTREE_PATH`, `VIBE_ORIGIN_PATH` |\n| `post_start` | worktree作成後                           | `VIBE_WORKTREE_PATH`, `VIBE_ORIGIN_PATH` |\n| `pre_clean`  | worktree削除前（現在のworktreeで実行）   | `VIBE_WORKTREE_PATH`, `VIBE_ORIGIN_PATH` |\n| `post_clean` | worktree削除後（メインリポジトリで実行） | `VIBE_WORKTREE_PATH`, `VIBE_ORIGIN_PATH` |\n\n**注意**: `post_clean`フックは削除コマンドに`\u0026\u0026`で連結され、`git worktree remove`コマンド完了後にメインリポジトリディレクトリで実行されます。\n\n### フック実行時の出力動作\n\nVibeはフック実行中にタスクの状態を表示するリアルタイム進捗ツリーを表示します。フックの出力は状況に応じて以下のように処理されます：\n\n- **進捗表示が有効な場合**: フックの標準出力は抑制され、進捗ツリーのみが表示されます。これにより視覚的に見やすくなります。\n- **進捗表示が無効な場合**: フックの標準出力は標準エラー出力に書き込まれます（シェルラッパーの`eval`との干渉を避けるため）。\n- **失敗したフック**: 進捗表示の有無にかかわらず、常に標準エラー出力が表示されます。これはデバッグを支援するためです。\n\n進捗表示の例：\n\n```\n✶ Setting up worktree feature/new-ui…\n┗ ☒ Pre-start hooks\n   ┗ ☒ npm install\n     ☒ cargo build --release\n  ⠋ Copying files\n   ┗ ⠋ .env.local\n     ☐ node_modules/\n```\n\n**注意**: 進捗表示は非TTY環境（CI/CDなど）では自動的に無効になり、フックの出力が通常通り表示されます。\n\n### 環境変数\n\nすべてのフックコマンド内で以下の環境変数が使えます：\n\n| 変数名               | 説明                         |\n| -------------------- | ---------------------------- |\n| `VIBE_WORKTREE_PATH` | 作成されたworktreeの絶対パス |\n| `VIBE_ORIGIN_PATH`   | 元リポジトリの絶対パス       |\n\n## セキュリティ\n\nVibe は CLI ツールのセキュリティベストプラクティスに従っています：\n\n- **シェルインジェクション防止**: すべてのシェル出力は `escapeShellPath()` でエスケープされ、細工されたディレクトリ名によるコマンドインジェクションを防止\n- **シェル文字列実行の排除**: `exec`/`execSync` の代わりに Node.js の `spawn` を使用し、シェル解釈を回避\n- **設定ファイルの信頼メカニズム**: `.vibe.toml` と `.vibe.local.toml` の SHA-256 ハッシュ検証\n- **パスバリデーション**: ユーザー入力のパスはすべて使用前に検証\n\n詳細なセキュリティチェックリストは [docs/SECURITY_CHECKLIST.ja.md](docs/SECURITY_CHECKLIST.ja.md) を参照してください。\n\n## 開発への参加\n\n開発環境のセットアップとガイドラインについては [CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。\n\n## ライセンス\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkexi%2Fvibe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkexi%2Fvibe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkexi%2Fvibe/lists"}