はじめに

vibeとは？

vibeはGit Worktreeの管理を簡素化するCLIツールです。以下のことができます：

• メインリポジトリを離れずに新機能用のWorktreeを作成
• 設定ファイルや依存関係を自動的にコピー
• Worktreeの作成・クリーンアップ時にセットアップフックを実行
• 対話的なプロンプトでWorktreeのライフサイクルを安全に管理

クイックスタート

1. vibeをインストール

Homebrew

brew install kexi/tap/vibe

npm/npx

# グローバルインストール
npm install -g @kexi/vibe

# またはnpxで直接実行
npx @kexi/vibe start feat/my-feature

ノート

シェル設定（ステップ2）が必要です。npxを使用する場合は「npx用」のコマンドを選択してください。

ヒント

頻繁に使用する場合はグローバルインストールを推奨します。npxはパッケージ解決のため起動が遅くなります。

Bun

# グローバルインストール
bun add -g @kexi/vibe

# またはbunxで直接実行
bunx @kexi/vibe start feat/my-feature

ノート

シェル設定（ステップ2）が必要です。bunxを使用する場合は「bunx用」のコマンドを選択してください。

ヒント

頻繁に使用する場合はグローバルインストールを推奨します。bunxはパッケージ解決のため起動が遅くなります。

Linux

# Ubuntu/Debian (x64)
curl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_amd64.deb
sudo apt install ./vibe_amd64.deb

# その他のディストリビューション (x64)
curl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-x64 -o vibe
chmod +x vibe && sudo mv vibe /usr/local/bin/

Windows

npm install -g @kexi/vibe

Windows x64 は @kexi/vibe-win32-x64 バイナリパッケージ経由でサポートされています。WSL2 ユーザーは上記の Linux 手順も利用できます。

2. シェルを設定

インストール方法に応じて、以下のいずれか1つをシェル設定に追加：

Zsh

# ~/.zshrc に追加（いずれか1つを選択）

# グローバルインストール用（Homebrew, npm -g, bun -g）
vibe() { eval "$(command vibe "$@")" }

# npx用（グローバルインストールなし）
vibe() { eval "$(npx @kexi/vibe "$@")" }
# bunx用:
# vibe() { eval "$(bunx @kexi/vibe "$@")" }

Bash

# ~/.bashrc に追加（いずれか1つを選択）

# グローバルインストール用（Homebrew, npm -g, bun -g）
vibe() { eval "$(command vibe "$@")"; }

# npx用（グローバルインストールなし）
vibe() { eval "$(npx @kexi/vibe "$@")"; }
# bunx用:
# vibe() { eval "$(bunx @kexi/vibe "$@")"; }

Fish

# ~/.config/fish/config.fish に追加（いずれか1つを選択）

# グローバルインストール用（Homebrew, npm -g, bun -g）
function vibe
    eval (command vibe $argv)
end

# npx用（グローバルインストールなし）
function vibe
    eval (npx @kexi/vibe $argv)
end
# bunx用:
# function vibe
#     eval (bunx @kexi/vibe $argv)
# end

Nushell

# ~/.config/nushell/config.nu に追加（いずれか1つを選択）

# グローバルインストール用（Homebrew, npm -g, bun -g）
def --env --wrapped vibe [...args] {
    let out = (^vibe --eval-dialect nu ...$args)
    for line in ($out | lines) {
        if ($line | str starts-with "__VIBE_CD__") {
            cd ($line | str replace "__VIBE_CD__" "")
        } else {
            print $line
        }
    }
}

# npx用（グローバルインストールなし）
def --env --wrapped vibe [...args] {
    let out = (npx @kexi/vibe --eval-dialect nu ...$args)
    for line in ($out | lines) {
        if ($line | str starts-with "__VIBE_CD__") {
            cd ($line | str replace "__VIBE_CD__" "")
        } else {
            print $line
        }
    }
}
# bunx用:
# def --env --wrapped vibe [...args] {
#     let out = (bunx @kexi/vibe --eval-dialect nu ...$args)
#     for line in ($out | lines) {
#         if ($line | str starts-with "__VIBE_CD__") {
#             cd ($line | str replace "__VIBE_CD__" "")
#         } else {
#             print $line
#         }
#     }
# }

ノート

vibe 2.2.0 以降と nushell 0.83 以降が必要です。以前に貼り付けた nu -c を使うスニペットは 置き換えてください。あれは実際にはディレクトリを変更できておらず、フラグを伴うコマンドも 拒否していました。--wrapped（フラグを ...args に通すため）と for（nushell は each の クロージャ内での環境変更を破棄するため）の両方を残してください。

PowerShell

# $PROFILE に追加（いずれか1つを選択）

# グローバルインストール用（Homebrew, npm -g, bun -g）
function vibe { $out = & vibe.exe --eval-dialect powershell @args; if ($out) { Invoke-Expression ($out -join "`n") } }

# npx用（グローバルインストールなし）
function vibe { $out = & npx @kexi/vibe --eval-dialect powershell @args; if ($out) { Invoke-Expression ($out -join "`n") } }
# bunx用:
# function vibe { $out = & bunx @kexi/vibe --eval-dialect powershell @args; if ($out) { Invoke-Expression ($out -join "`n") } }

ノート

vibe 2.2.0 以降が必要です。以前に貼り付けた Invoke-Expression (& vibe.exe $args) の スニペットは置き換えてください。あれはシングルクォートを含むパスを正しく扱えず、 vibe が何も出力しないときにエラーを送出していました。

3. 最初のWorktreeを作成

# 新機能の作業を開始
vibe start feat/my-new-feature

# ターミナルは新しいWorktreeに移動しています！
# 変更を加えて、コミット、プッシュなど...

# 作業完了後、Worktreeをクリーンアップ
vibe clean

基本的なワークフロー

メインリポジトリ
     │
     ├── vibe start feat/feature-a  →  repo-feat-feature-a/
     │                                      │
     │                                      └── (機能を開発)
     │
     └── vibe clean  ←─────────────────────────┘
           (メインに戻り、Worktreeを削除)

次のステップ

• インストール - 詳細なインストール手順
• シェル設定 - シェルの設定
• 設定 - .vibe.tomlのセットアップ