はじめに

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

Invoke-WebRequest -Uri "https://github.com/kexi/vibe/releases/latest/download/vibe-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\vibe.exe"
# PATHに追加（初回のみ）
$path = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$path;$env:LOCALAPPDATA", "User")

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 vibe [...args] {
    ^vibe ...$args | lines | each { |line| nu -c $line }
}

# npx用（グローバルインストールなし）
def --env vibe [...args] {
    npx @kexi/vibe ...$args | lines | each { |line| nu -c $line }
}
# bunx用:
# def --env vibe [...args] {
#     bunx @kexi/vibe ...$args | lines | each { |line| nu -c $line }
# }

PowerShell

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

# グローバルインストール用（Homebrew, npm -g, bun -g）
function vibe { Invoke-Expression (& vibe.exe $args) }

# npx用（グローバルインストールなし）
function vibe { Invoke-Expression (& npx @kexi/vibe $args) }
# bunx用:
# function vibe { Invoke-Expression (& bunx @kexi/vibe $args) }

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のセットアップ