
실시간 트래픽 기록 및 재생 기능이 있는 자동화 테스트 스위트

[!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> # 적용할 차이(diffs) 가져오기
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:
Windows에서는 최상의 경험을 위해 WSL 사용을 권장합니다. 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을 입력한 후 Enter 키를 누릅니다.Path를 선택하고 "편집"을 클릭합니다.tusk.exe가 있는 폴더를 추가합니다.터미널을 다시 시작하고 확인합니다:
tusk --version
참고: Windows에서 테스트를 실행하려면 추가 구성이 필요합니다. TCP 통신 모드 설정에 대한 자세한 내용은 을 참조하세요.
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를 참조하세요.