Shell Setup

vibe needs a shell wrapper function to change directories after creating or cleaning up worktrees. Add the appropriate configuration to your shell.

Shell Configuration

Zsh

Add to ~/.zshrc:

vibe() { eval "$(command vibe "$@")" }

Bash

Add to ~/.bashrc:

vibe() { eval "$(command vibe "$@")"; }

Fish

Add to ~/.config/fish/config.fish:

function vibe
    eval (command vibe $argv)
end

Nushell

Add to ~/.config/nushell/config.nu:

def --env vibe [...args] {
    ^vibe ...$args | lines | each { |line| nu -c $line }
}

PowerShell

Add to your $PROFILE:

function vibe { Invoke-Expression (& vibe.exe $args) }

Why is this needed?

When vibe creates a worktree, it needs to change your current working directory to the new worktree. However, a subprocess cannot change the parent process’s directory directly.

The shell wrapper function captures vibe’s output (which contains shell commands like cd /path/to/worktree) and executes it in the current shell context.

Verify Installation

After adding the shell configuration, reload your shell and verify:

# Reload your shell or open a new terminal
source ~/.zshrc  # or ~/.bashrc, etc.

# Check vibe is working
vibe --help

Next Steps

• Configuration - Set up .vibe.toml for automated workflows
• Commands - Learn about available commands