Git worktree helper CLI
npm install @kexi/vibeA CLI tool for easy Git Worktree management.
``bashGlobal install
npm install -g @kexi/vibe
> Note: The npm package includes optional native bindings (
@kexi/vibe-native) for optimized Copy-on-Write file cloning on macOS (APFS) and Linux (Btrfs/XFS). These are automatically used when available.$3
For alternative installation options (Homebrew, Deno, mise, Linux packages, Windows), see the GitHub repository.
Documentation
Full documentation is available at vibe.kexi.dev
Usage
| Command | Description |
| --------------------- | --------------------------------------------------------------------------------- |
|
vibe start | Create a worktree with a new or existing branch (idempotent) |
| vibe clean | Delete current worktree and return to main (prompts if uncommitted changes exist) |
| vibe trust | Trust .vibe.toml and .vibe.local.toml files |
| vibe untrust | Untrust .vibe.toml and .vibe.local.toml files |$3
`bash
Create a worktree with a new branch
vibe start feat/new-featureUse an existing branch (or re-run if worktree already exists)
vibe start feat/existing-branchAfter work is done, delete the worktree
vibe clean
`$3
| Option | Description |
| ----------------- | ------------------------------------------------- |
|
-h, --help | Show help message |
| -v, --version | Show version information |
| -V, --verbose | Show detailed output |
| -q, --quiet | Suppress non-essential output |
| -n, --dry-run | Preview operations without executing (start only) |Setup
Add the following to your shell configuration:
Zsh (.zshrc)
`bash
vibe() { eval "$(command vibe "$@")" }
`
Bash (.bashrc)
`bash
vibe() { eval "$(command vibe "$@")"; }
`
Fish (~/.config/fish/config.fish)
`fish
function vibe
eval (command vibe $argv)
end
`
PowerShell ($PROFILE)
`powershell
function vibe { Invoke-Expression (& vibe.exe $args) }
`Configuration
Place a
.vibe.toml file in the repository root to automatically run tasks on vibe start:`toml
Copy files and directories from origin repository to worktree
[copy]
files = [".env"]
dirs = ["node_modules", ".cache"]Commands to run after worktree creation
[hooks]
post_start = [
"pnpm install",
"pnpm db:migrate"
]
`Trust registration is required on first use with
vibe trust`.For detailed configuration options including:
- Glob patterns for file copying
- Copy performance optimization (Copy-on-Write)
- Worktree path customization
- Security and hash verification
- Local configuration overrides
See the full documentation.
Apache-2.0