安装

包管理器

brew install kexi/tap/vibe

# 全局安装
npm install -g @kexi/vibe

# 或使用 npx 直接运行
npx @kexi/vibe start feat/my-feature

# 全局安装
bun add -g @kexi/vibe

# 或使用 bunx 直接运行
bunx @kexi/vibe start feat/my-feature

添加到你的 .mise.toml：

[plugins]
vibe = "https://github.com/kexi/mise-vibe"

[tools]
vibe = "latest"

然后运行：

mise install

# 直接运行（临时）
nix run github:kexi/vibe -- start feat/my-feature

# 持久化安装
nix profile install github:kexi/vibe

对于 NixOS 或 Home Manager，可将其添加为 flake input：

{
  inputs.vibe.url = "github:kexi/vibe";

  # 然后在你的配置中使用：
  # environment.systemPackages = [ inputs.vibe.packages.${system}.default ];
}

默认软件包（packages.default / .#fromSource）为了可复现性会从源码构建。如果你更希望使用预编译的发行版二进制文件（跳过编译，并通过 SHA-256 哈希校验），请使用 packages.binary：

nix run github:kexi/vibe#binary -- start feat/my-feature

Linux

Ubuntu/Debian
其他发行版

# x64
curl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_amd64.deb
sudo apt install ./vibe_amd64.deb

# ARM64
curl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_arm64.deb
sudo apt install ./vibe_arm64.deb

# 卸载
sudo apt remove vibe

该软件包会将其许可证文档安装到 /usr/share/doc/vibe/ 目录下： copyright（vibe 自身的 MIT 许可条款，采用 Debian 的机器可读 DEP-5 格式）和 THIRD-PARTY-LICENSES.md（静态链接进该二进制文件的 Rust crate 的许可声明）。

# x64
curl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-x64 -o vibe
chmod +x vibe
sudo mv vibe /usr/local/bin/

# ARM64
curl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-arm64 -o vibe
chmod +x vibe
sudo mv vibe /usr/local/bin/

Windows

vibe 支持 Windows（x64）。通过 npm 安装即可 —— @kexi/vibe 启动器会拉取适用于你所在平台的 @kexi/vibe-win32-x64 二进制软件包：

npm install -g @kexi/vibe

从源码构建

在安装了 Rust 工具链之后，你可以从源码构建二进制文件：

git clone https://github.com/kexi/vibe.git
cd vibe
cargo build --manifest-path rust/Cargo.toml -p vibe --release
# 二进制文件会输出到 rust/target/release/vibe

下一步

安装完成后，请设置你的 shell以启用 vibe 的目录切换功能。