SECCIÓN 02

Configuración inicial

El comando setup te guía por la configuración completa en cuatro pasos. Puedes correrlo en modo interactivo o en modo automático (--auto).

Modo automático — recomendado para onboarding

ixtli setup --auto

Aplica los defaults inteligentes sin hacer preguntas:

  • Verifica que haya una API key configurada (si no hay, sale con error)
  • Indexa el proyecto (PIL)
  • Instala hooks pre-commit (modo warning) y pre-push
  • Detecta Claude Code, Cursor, Aider, Cline, Codex y configura cada uno automáticamente
  • Inyecta la guía del agente en CLAUDE.md (para Claude Code)

Modo interactivo

ixtli setup

Pasos del wizard:

  1. API key — introduce o verifica tu key de ixtli
  2. PIL index — opcionalmente inicializa el índice de inteligencia del proyecto
  3. Git hooks — instala hooks pre-commit y pre-push, con opción de elegir si bloquean o solo advierten
  4. Integraciones AI — detecta herramientas instaladas y configura cada una

Cada paso es opcional y puedes saltarlo con n. Todos se pueden configurar individualmente después.

Resumen al finalizar

Al terminar setup, verás un resumen contextual de tu flujo de trabajo:

  Tu workflow:

  git commit
    → ixtli revisa archivos staged automáticamente
    → issues críticos muestran un warning en la terminal

  Claude Code
    → auto-reviews antes de cada tool call
    → agente guiado por CLAUDE.md (prefiere CLI sobre MCP)
    → /ixtli-review, /ixtli-re-review slash commands disponibles
    → MCP tools también disponibles como fallback

  Comandos rápidos:
    ixtli review          — revisar archivos staged ahora
    ixtli doctor          — verificar estado en cualquier momento
    ixtli hooks status    — ver configuración de git hooks

Modo agente — dejar que tu coding agent lo configure

Si trabajas con Claude Code, Cursor, Aider o cualquier agente que pueda correr comandos de shell, puedes pegarle esto directamente en vez de instalar y configurar tú mismo:

Instala y configura ixtli en este proyecto:

1. Verifica si ya está instalado: `ixtli --version`
2. Si no, instálalo: `curl -fsSL https://cdn.ixtli.app/install | bash`
   (si ~/.local/bin no está en el PATH, agrégalo a mi shell profile)
3. Corre `ixtli setup --auto` para configurar API key, git hooks e integración contigo mismo
   - Si pide una API key y no la tengo, dime y consíguela en https://ixtli.app/dashboard/profile
4. Verifica que todo quedó bien con `ixtli doctor`
5. Resume qué se configuró y qué comandos puedo usar ahora

El agente termina con todo instalado, configurado, y un resumen de lo que puede hacer — sin que tengas que tocar la terminal.

InstalaciónHealth check — ixtli doctor