SECCIÓN 11

Integración con herramientas AI

ixtli se integra con los principales agentes de coding para que el review ocurra en el flujo de trabajo del agente, de la forma más eficiente posible.

Estrategia shell-first

La integración preferida con agentes de coding no usa el servidor MCP, sino comandos de shell directos. Esto tiene varias ventajas:

Menor overhead de tokens — los MCP tools requieren sus schemas en el contexto del modelo
Sin servidor — no hay proceso adicional que iniciar
Más simple — el agente corre ixtli review --json y parsea stdout, igual que cualquier otra herramienta CLI

Cuando instalas la integración con ixtli setup, se configura una guía del agente en el archivo de instrucciones de cada herramienta (CLAUDE.md, .cursorrules, .clinerules, etc.) que le enseña al agente cómo usar la CLI directamente.

El servidor MCP sigue disponible como fallback para flujos que lo requieren explícitamente.

Detectar herramientas instaladas

ixtli tools detect

Detecta Claude Code, Cursor, Cline, Aider, Codex y muestra cuáles están disponibles en el sistema.

Instalar integraciones individualmente

ixtli tools install-skill claude     # Claude Code
ixtli tools install-skill cursor     # Cursor IDE
ixtli tools install-skill cline      # Cline (VS Code)
ixtli tools install-skill aider      # Aider
ixtli tools install-skill codex      # OpenAI Codex CLI
ixtli tools install-skill --all      # todos los detectados

Claude Code

ixtli setup instala:

Slash commands en .claude/commands/:

Comando	Descripción
`/ixtli-review`	Revisar archivos staged con `--json`, mostrar issues y corregir los blocking
`/ixtli-re-review <archivo>`	Verificar que los fixes aplicados resolvieron los issues del último review
`/ixtli-commit`	Revisar staged changes y generar mensaje de commit
`/ixtli-issues`	Ver issues del último review en JSON

Hooks en .claude/settings.json:

Hook	Cuándo se dispara	Comando
`PreToolUse` (Bash)	Antes de que Claude ejecute cualquier comando	`ixtli review --quiet --min-severity high`
`PostToolUse` (Bash)	Después de que Claude ejecute cualquier comando	`ixtli index update --silent`

Los hooks corren en background — el agente no los invoca explícitamente y no consumen tokens de su contexto.

CLAUDE.md — Guía del agente inyectada automáticamente:

ixtli setup # → inyecta la guía en CLAUDE.md del proyecto

La guía enseña a Claude a:

Correr ixtli review --json directamente
Parsear el JSON y corregir issues critical y high
Correr ixtli re-review <file> --json --resolved-json '...' después de aplicar fixes
Interpretar los exit codes
Preferir CLI sobre MCP tools para reducir overhead de tokens

Servidor MCP en .mcp.json — disponible como fallback (ver sección 12).

Cursor

ixtli setup instala:

.cursorrules — guía completa del agente (formato legacy, aún leído por Cursor):

## ixtli — AI Code Review

ixtli is configured in this project. Run CLI commands directly...

ixtli review --json
ixtli re-review <file> --json --resolved-json '[...]'

.cursor/rules/ixtli.mdc — nuevo formato de Cursor con alwaysApply: true:

---
description: ixtli AI code review CLI guide
alwaysApply: true
---
[guía completa]

.vscode/tasks.json — tasks disponibles desde la paleta de comandos de VS Code:

Task	Comando
`ixtli: review staged`	`ixtli review`
`ixtli: commit-review`	`ixtli commit-review`
`ixtli: re-review file`	`ixtli re-review ${relativeFile}`

Cline

ixtli setup instala:

.clinerules — guía completa del agente (igual que CLAUDE.md). Cline lee este archivo automáticamente en cada sesión.

Configuración MCP de Cline — registra ixtli en cline_mcp_settings.json del editor (VS Code, Cursor).

Aider

ixtli setup agrega a .aider.conf.yml:

# ixtli — added by ixtli CLI
auto-commits: false
pre-cmd: ixtli review --quiet --min-severity high

# ixtli CLI reference:
#   ixtli review --json
#   ixtli re-review <file> --json \
#     --resolved-json '[{"issue_id":"<id>","issue":"...","fix_applied":"..."}]'
#   Exit codes: 0=clean, 1=blocking issues, 2=error, 3=no files

El pre-cmd corre ixtli review antes de cada sesión de edición. Las referencias en comentarios orientan a Aider sobre cómo usar la CLI directamente.

Codex CLI (OpenAI)

ixtli setup agrega a ~/.codex/config.yaml:

tools:
  # ixtli — added by ixtli CLI
  - name: ixtli-review
    description: >
      Review staged files for bugs and security issues.
      Use --json for structured output. Exit 0=clean, 1=blocking issues.
    command: ixtli review --json
  - name: ixtli-commit-review
    description: >
      Review staged changes and get a suggested commit message.
    command: ixtli commit-review --json
  - name: ixtli-re-review
    description: >
      Verify that issues from a previous review were properly fixed.
      Pass --resolved-json with a JSON array of resolved issues.
    command: ixtli re-review

Flujo completo de un agente con ixtli

Este es el flujo que ocurre cuando un agente de coding usa ixtli correctamente:

1. El agente termina de editar auth.py
   → (Hook PreToolUse) ixtli review --quiet se dispara automáticamente

2. Si hay issues, el agente corre:
   ixtli review src/api/auth.py --json
   → encuentra SQL injection en auth.py:42

3. El agente aplica el fix

4. El agente verifica el fix:
   ixtli re-review src/api/auth.py --json \
     --resolved-json '[{"issue_id":"abc","issue":"SQL injection","fix_applied":"Parameterized queries"}]'
   → {"resolved": ["SQL injection"], "still_present": [], "new_issues": []}

5. El archivo está limpio. El agente procede.

Listar integraciones instaladas

ixtli tools list-skills

Desinstalar

ixtli tools uninstall-skill claude
ixtli tools uninstall-skill cursor

Issue Trackers MCP Server