SECCIÓN 01

Instalación

Método recomendado — script de instalación

curl -fsSL https://cdn.ixtli.app/install | bash

El script detecta tu sistema operativo y arquitectura, descarga el binario correcto, verifica su checksum SHA-256 e instala en ~/.local/bin/ixtli. No requiere Python, pip ni ningún runtime.

Plataformas soportadas:

SOArquitectura
Linux (incluye WSL)x86_64, arm64
macOSIntel (x86_64, vía Rosetta 2), Apple Silicon (arm64)

Windows nativo (cmd/PowerShell sin WSL) no está soportado — no se construye binario para Windows y no hay planes próximos de hacerlo. Dentro de WSL, ixtli funciona igual que en cualquier distro Linux (el script de instalación detecta WSL como Linux normal), incluyendo los git hooks.

Variables de entorno del script:

# Instalar una versión específica
IXTLI_VERSION=v1.2.0 curl -fsSL https://cdn.ixtli.app/install | bash

# Instalar en un directorio distinto
IXTLI_INSTALL_DIR=/usr/local/bin curl -fsSL https://cdn.ixtli.app/install | bash

Si ~/.local/bin no está en tu PATH, el script te avisa. Para agregarlo permanentemente:

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Al finalizar, el script te indicará el siguiente paso:

  ¡Listo! Para configurar todo en un paso:

    ixtli setup --auto

  Esto instala los git hooks, indexa tu proyecto y conecta tu
  agente de AI (Claude Code, Cursor, etc.) automáticamente.

Verificar instalación

ixtli --version
# ixtli v1.0.0

Actualizar

ixtli self-update

ixtli verifica si hay una versión más nueva, descarga el binario de tu plataforma, verifica el checksum y reemplaza el binario actual.

Para actualizar a una versión específica:

ixtli self-update --version v1.2.0
Configuración inicial