tusk-cli

[!IMPORTANT] ¿Usabas antes tusk-drift-cli? Este repositorio se ha movido a tusk-cli, y las versiones antiguas instaladas de la CLI pueden no actualizarse automáticamente tras el cambio de nombre. Vuelve a instalar usando las instrucciones de instalación actuales que se muestran a continuación.

La CLI Tusk proporciona herramientas para flujos de trabajo de pruebas automatizadas. Es compatible con tres productos:

• Tusk Drift — Grabación/reproducción de tráfico en vivo como pruebas de API
• Tusk Review — Revisión de código por IA en tu árbol de trabajo local
• Tusk Unit — Pruebas unitarias automatizadas

Tusk Drift — Pruebas de Grabación/Reproducción de API

Graba tráfico real de API y reprodúcelo como pruebas deterministas. Funciona localmente y en CI/CD con Tusk Drift Cloud.

tusk drift setup          # Agente de configuración por IA
tusk drift run            # Reproduce trazas grabadas
tusk drift run --cloud    # Ejecuta contra Tusk Drift Cloud

Comienza con Tusk Drift →

Tusk Review — Revisión de Código por IA

Ejecuta la revisión de código por IA de Tusk contra tu árbol de trabajo local — incluyendo cambios sin confirmar y sin seguimiento — antes de hacer push o abrir un pull request. Los resultados se imprimen en tu terminal; no se publica nada en GitHub ni GitLab.

tusk review run                         # Revisa el árbol de trabajo actual
tusk review run --no-poll               # Envía y sale con el ID de ejecución
tusk review status <run-id> --watch     # Consulta una ejecución enviada anteriormente

Comienza con Tusk Review →

Tusk Unit — Pruebas Unitarias Automatizadas

Visualiza, revisa y aplica pruebas unitarias de Tusk directamente desde tu terminal o pipeline de automatización.

tusk unit latest-run                    # Última ejecución para la rama actual
tusk unit get-run <run-id>              # Detalles completos de la ejecución
tusk unit get-diffs <run-id>            # Obtiene diferencias para aplicar

Comienza con Tusk Unit →

Instalación

Instalación rápida (recomendada)

Linux/macOS:

Instala la última versión:

curl -fsSL https://cli.usetusk.ai/install.sh | sh

Para instalar una versión específica:

curl -fsSL https://cli.usetusk.ai/install.sh | sh -s -- v1.2.3

Dependencias adicionales de Linux (para el sandboxing de reproducción):

• Debian/Ubuntu: sudo apt install bubblewrap socat
• Fedora/RHEL: sudo dnf install bubblewrap socat
• Arch: sudo pacman -S bubblewrap socat

Sin ellas, el sandboxing está deshabilitado y las reproducciones se ejecutan sin aislamiento de red. Consulta Arquitectura - Sandboxing.

Homebrew:

brew tap use-tusk/tap
brew install use-tusk/tap/tusk

Para actualizar:

brew upgrade use-tusk/tap/tusk

Windows:

Recomendamos usar WSL para la mejor experiencia en Windows. Con WSL, puedes usar los pasos de instalación de Linux/macOS anteriores y evitar la configuración específica de Windows. Para una instalación nativa en Windows sin WSL, expande abajo para ver los pasos.

Pasos de instalación

Descarga la última versión desde [GitHub Releases](https://github.com/Use-Tusk/tusk-cli/releases/latest):

1. Descarga tusk-cli_*_Windows_x86_64.zip (o arm64 para Windows basado en ARM)

2. Extrae el archivo ZIP

3. Mueve tusk.exe a un directorio en tu PATH (p. ej., C:\tools\), o añade el directorio extraído a tu PATH:

   Opción A: Añadir al PATH mediante PowerShell (ejecutar como Administrador):

   [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\ruta\a\tusk", "User")
   

   Opción B: Añadir al PATH mediante Configuración del Sistema:

   • Presiona Win + R, escribe sysdm.cpl, presiona Enter
   • Haz clic en "Variables de entorno"
   • En "Variables de usuario", selecciona Path y haz clic en "Editar"
   • Haz clic en "Nuevo" y añade la carpeta que contiene tusk.exe
   • Haz clic en Aceptar para guardar

4. Reinicia tu terminal y verifica:

   tusk --version
   

Nota: Windows requiere configuración adicional para ejecutar pruebas. Consulta Soporte para Windows para obtener detalles sobre la configuración del modo de comunicación TCP.

Descarga manual

Descarga binarios precompilados desde GitHub Releases.

Compilar desde el código fuente

# Go 1.25+
git clone https://github.com/Use-Tusk/tusk-cli.git
cd tusk-cli
make deps
make build

tusk --help

Comunidad

Únete a nuestra comunidad de código abierto en Slack.

Desarrollo

Ver CONTRIBUTING.md.

Licencia

Ver LICENSE.