Commands Overview

vibe provides a simple set of commands for managing Git Worktrees.

Command Summary

Command	Description
vibe start <branch> [--base <ref>]	Create a worktree with a new or existing branch
vibe scratch	Create a worktree with an auto-generated scratch/ name
vibe jump <branch>	Jump to an existing worktree by branch name
vibe rename <new-name>	Rename the current worktree’s branch and directory
vibe clean	Delete current worktree and return to main
vibe home	Return to main worktree without removing current
vibe trust	Trust configuration files
vibe untrust	Untrust configuration files
vibe config	Show current configuration
vibe upgrade	Check for updates and show upgrade instructions
vibe shell-setup	Print shell wrapper function (and optional completion)

Quick Reference

# Create a worktree for a new feature
vibe start feat/new-feature

# Use an existing branch
vibe start feat/existing-branch

# Create from a specific base branch
vibe start feat/new-feature --base main

# Clean up when done
vibe clean

# Return to main worktree without removing current
vibe home

# Trust configuration files
vibe trust

# Show current config
vibe config

# Check for updates
vibe upgrade

Global Options

These options are available for most commands:

Option	Description
-h, --help	Show help message
-v, --version	Show version information
-V, --verbose	Show detailed output
-q, --quiet	Suppress non-essential output

Detailed Documentation

• start - Create worktrees
• scratch - Create auto-named “scratch” worktrees
• jump - Jump between worktrees
• rename - Rename the current worktree
• clean - Remove worktrees
• home - Navigate to main worktree
• trust - Manage configuration trust
• config - View configuration
• upgrade - Check for updates
• shell-setup - Print shell wrapper function and fish completion