Skip to content
vibe

Configuration Overview

vibe can be configured using TOML files to automate your workflow when creating and cleaning up worktrees.

Configuration Files

Section titled “Configuration Files”
File Purpose Location Git tracked
.vibe.toml Shared team configuration Repository root Yes
.vibe.local.toml Personal local overrides Repository root No (gitignored)
settings.json User-specific global settings ~/.config/vibe/ No (user home)

Basic Example

Section titled “Basic Example”

Create a .vibe.toml file in your repository root:

# Copy files and directories from origin repository to worktree
[copy]
files = [".env"]
dirs = ["node_modules", ".cache"]


# Commands to run after worktree creation
[hooks]
pre_start = ["echo 'Preparing worktree...'"]
post_start = [
  "pnpm install",
  "pnpm db:migrate"
]
pre_clean = ["git stash"]
post_clean = ["echo 'Cleanup complete'"]

First-time Setup

Section titled “First-time Setup”

Before using configuration files, you need to trust them:

Terminal window
vibe trust

This registers the SHA-256 hash of your configuration files to prevent unauthorized modifications.

Configuration Topics

Section titled “Configuration Topics”