Shell 设置

vibe 需要一个 shell 包装函数，才能在创建或清理 worktree 之后切换目录。请将相应的配置添加到你的 shell 中。

Shell 配置

Zsh

请将以下内容中的其中一项添加到 ~/.zshrc。不要同时添加两者 —— 否则包装函数会被定义两次。

推荐 —— 包装函数 + Tab 补全（子命令、标志，以及 vibe start / vibe jump 的分支名）：

autoload -Uz compinit && compinit
eval "$(vibe shell-setup --shell zsh --with-completion)"

这两行会同时定义 vibe 包装函数并注册 zsh 补全。compinit 那一行是 zsh 补全系统所必需的 —— 如果你已经在 ~/.zshrc 的其他地方调用了 compinit，请把 eval 那一行放在该调用之后。如果 compinit 未被执行，补全注册会被静默跳过，但 vibe 包装函数仍会被定义。

仅包装函数（无 Tab 补全）：

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

Bash

添加到 ~/.bashrc：

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

Fish

请将以下内容中的其中一项添加到 ~/.config/fish/config.fish。不要同时添加两者 —— 否则包装函数会被定义两次。

推荐 —— 包装函数 + Tab 补全（子命令、标志，以及 vibe start / vibe jump 的分支名）：

vibe shell-setup --shell fish --with-completion | source

仅这一行就能同时定义 vibe 包装函数并注册 fish 补全。

仅包装函数（无 Tab 补全）：

function vibe
    eval (command vibe $argv)
end

Nushell

添加到 ~/.config/nushell/config.nu：

def --env --wrapped vibe [...args] {
    let out = (^vibe --eval-dialect nu ...$args)
    for line in ($out | lines) {
        if ($line | str starts-with "__VIBE_CD__") {
            cd ($line | str replace "__VIBE_CD__" "")
        } else {
            print $line
        }
    }
}

注意

需要 vibe 2.2.0 或更高版本，以及 nushell 0.83 或更高版本。如果你之前粘贴过旧的 nu -c 代码片段，请将其替换 —— 那个版本实际上从未改变过你的目录，因为 nu -c 是在子进程中执行 cd 的，而且它会拒绝任何带标志的命令。--wrapped 和 for 两者都是必需的：--wrapped 让标志能传递到 ...args，而 nushell 会丢弃在 each 闭包内所做的环境变更。 运行 vibe doctor 可以检查此前粘贴的包装函数是否为当前版本。

PowerShell

添加到你的 $PROFILE：

function vibe { $out = & vibe.exe --eval-dialect powershell @args; if ($out) { Invoke-Expression ($out -join "`n") } }

注意

需要 vibe 2.2.0 或更高版本。如果你之前粘贴过旧的 Invoke-Expression (& vibe.exe $args) 代码片段，请将其替换 —— 那个版本无法正确处理 包含单引号的路径，并且在 vibe 没有产生任何输出时会抛出错误。 运行 vibe doctor 可以检查此前粘贴的包装函数是否为当前版本。

使用 mise（自动配置）

如果你是通过 mise 安装 vibe 的，可以利用 mise 的 hooks 功能来自动完成 shell 设置。

将以下内容添加到项目的 .mise.toml：

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

注意

这需要在你的 shell 中启用 mise activate。 enter 钩子会在你进入项目目录时自动运行，检测你所使用的 shell 并定义相应的包装函数。

为什么需要这样做？

当 vibe 创建 worktree 时，它需要把你当前的工作目录切换到新的 worktree。然而，子进程无法直接改变父进程的目录。

shell 包装函数会捕获 vibe 的输出（其中包含类似 cd /path/to/worktree 的 shell 命令），并在当前 shell 上下文中执行它。

验证安装

添加 shell 配置之后，重新加载你的 shell 并进行验证：

# 重新加载 shell 或打开一个新终端
source ~/.zshrc  # 或 ~/.bashrc 等

# 确认 vibe 可以正常工作
vibe --help

下一步

• 配置 - 设置 .vibe.toml 以实现自动化工作流
• 命令 - 了解可用的命令