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) }

Using mise (automatic setup)

If you installed vibe with mise, you can automate shell setup using mise’s hooks feature.

Add the following to your project’s .mise.toml:

[hooks]
enter = 'eval "$(vibe shell-setup)"'

Note

This requires mise activate in your shell. The enter hook runs automatically when you enter the project directory, detecting your shell and defining the appropriate wrapper function.

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