
Suite de testes automatizados com gravação e reprodução de tráfego ao vivo
[!IMPORTANT] Usava
tusk-drift-clianteriormente? Este repositório foi movido paratusk-cli, e versões antigas da CLI instaladas podem não atualizar automaticamente com a renomeação. Por favor, reinstale usando as instruções de instalação atuais abaixo.
A Tusk CLI fornece ferramentas para fluxos de trabalho de teste automatizados. Ela suporta três produtos:
Grave tráfego real de API e reproduza-o como testes determinísticos. Funciona localmente e em CI/CD com o Tusk Drift Cloud.
tusk drift setup # Agente de configuração com IA
tusk drift run # Reproduzir traces gravados
tusk drift run --cloud # Executar no Tusk Drift Cloud
Execute a revisão de código com IA do Tusk na sua árvore de trabalho local — incluindo alterações não commitadas e não rastreadas — antes de fazer push ou abrir um pull request. Os resultados são exibidos no terminal; nada é postado no GitHub ou GitLab.
tusk review run # Revisar a árvore de trabalho atual
tusk review run --no-poll # Enviar e sair com o ID da execução
tusk review status <run-id> --watch # Verificar uma execução enviada anteriormente
Visualize, revise e aplique testes unitários do Tusk diretamente do seu terminal ou pipeline de automação.
tusk unit latest-run # Última execução para o branch atual
tusk unit get-run <run-id> # Detalhes completos da execução
tusk unit get-diffs <run-id> # Obter diffs para aplicar
Linux/macOS:
Instale a versão mais recente:
curl -fsSL https://cli.usetusk.ai/install.sh | sh
Para instalar uma versão específica:
curl -fsSL https://cli.usetusk.ai/install.sh | sh -s -- v1.2.3
Dependências adicionais do Linux (para sandbox de replay):
sudo apt install bubblewrap socatsudo dnf install bubblewrap socatsudo pacman -S bubblewrap socatSem elas, o sandbox é desabilitado e os replays são executados sem isolamento de rede. Veja Arquitetura - Sandboxing.
Homebrew:
brew tap use-tusk/tap
brew install use-tusk/tap/tusk
Para atualizar:
brew upgrade use-tusk/tap/tusk
Windows:
Recomendamos usar o WSL para a melhor experiência no Windows. Com o WSL, você pode usar as etapas de instalação do Linux/macOS acima e evitar configurações específicas do Windows. Para instalação nativa no Windows sem WSL, expanda abaixo para ver as etapas.
Baixe tusk-cli_*_Windows_x86_64.zip (ou arm64 para Windows baseado em ARM)
Extraia o arquivo ZIP
Mova tusk.exe para um diretório no seu PATH (ex.: C:\tools\), ou adicione o diretório extraído ao seu PATH:
Opção A: Adicionar ao PATH via PowerShell (executar como Administrador):
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\caminho\para\tusk", "User")
Opção B: Adicionar ao PATH via Configurações do Sistema:
Win + R, digite sysdm.cpl, pressione EnterPath e clique em "Editar"tusk.exeReinicie o terminal e verifique:
tusk --version
Nota: O Windows requer configuração adicional para executar testes. Veja Suporte ao Windows para detalhes sobre a configuração do modo de comunicação TCP.
Baixe os binários pré-compilados do GitHub Releases.
# Go 1.25+
git clone https://github.com/Use-Tusk/tusk-cli.git
cd tusk-cli
make deps
make build
tusk --help
Junte-se à nossa comunidade open source no Slack.
Veja CONTRIBUTING.md.
Veja LICENSE.