
[!IMPORTANT] 之前使用的是
tusk-drift-cli?此仓库已迁移至tusk-cli,旧版本 CLI 可能无法在重命名后自动更新。请根据下方的安装说明重新安装。
Tusk CLI 提供自动化测试工作流的工具。它支持三种产品:
录制真实 API 流量并将其回放为确定性测试。可在本地和 CI/CD 环境中与 Tusk Drift Cloud 配合使用。
tusk drift setup # AI 设置代理
tusk drift run # 回放录制的追踪
tusk drift run --cloud # 针对 Tusk Drift Cloud 运行
在推送或创建拉取请求之前,对本地工作树(包括未提交和未跟踪的更改)运行 Tusk 的 AI 代码审查。结果输出到终端;不会发布到 GitHub 或 GitLab。
tusk review run # 审查当前工作树
tusk review run --no-poll # 提交并退出,返回运行 ID
tusk review status <run-id> --watch # 检查之前提交的运行
直接从终端或自动化流水线查看、审查和应用来自 Tusk 的单元测试。
tusk unit latest-run # 当前分支的最新运行
tusk unit get-run <run-id> # 完整运行详情
tusk unit get-diffs <run-id> # 获取要应用的差异
Linux/macOS:
安装最新版本:
curl -fsSL https://cli.usetusk.ai/install.sh | sh
安装特定版本:
curl -fsSL https://cli.usetusk.ai/install.sh | sh -s -- v1.2.3
Linux 额外依赖(用于回放沙箱):
sudo apt install bubblewrap socatsudo dnf install bubblewrap socatsudo pacman -S bubblewrap socat若未安装这些依赖,沙箱将被禁用,回放将在无网络隔离的情况下运行。详见 架构 - 沙箱。
Homebrew:
brew tap use-tusk/tap
brew install use-tusk/tap/tusk
更新:
brew upgrade use-tusk/tap/tusk
Windows:
我们建议使用 WSL 以获得 Windows 上的最佳体验。通过 WSL,您可以使用上述 Linux/macOS 安装步骤,避免 Windows 特定的配置。如需在未安装 WSL 的情况下进行原生 Windows 安装,请展开下方查看步骤。
下载 tusk-cli_*_Windows_x86_64.zip(对于基于 ARM 的 Windows 请下载 arm64 版本)
解压 ZIP 文件
将 tusk.exe 移动到 PATH 中的目录(例如 C:\tools\),或将解压后的目录添加到 PATH 中:
选项 A:通过 PowerShell(以管理员身份运行)添加到 PATH:
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\path\to\tusk", "User")
选项 B:通过系统设置添加到 PATH:
Win + R,输入 sysdm.cpl,按 EnterPath 并点击“编辑”tusk.exe 的文件夹重启终端并验证:
tusk --version
注意:Windows 需要额外配置才能运行测试。有关 TCP 通信模式设置的详细信息,请参阅 Windows 支持。
从 GitHub Releases 下载预构建的二进制文件。
# Go 1.25+
git clone https://github.com/Use-Tusk/tusk-cli.git
cd tusk-cli
make deps
make build
tusk --help
加入我们的开源社区,请访问 Slack。
参见 CONTRIBUTING.md。
参见 LICENSE。