LexQ CLI

La plataforma de decisiones para equipos de ingeniería. CLI y servidor MCP para LexQ — saca las reglas de negocio de tu pipeline de despliegue, prueba cada cambio con simulaciones y publica sin necesidad de un git push.

Sitio web · Documentación · Consola

npm Licencia

¿Por qué LexQ?

Tus reglas de negocio — precios, promociones, lógica de tarifas, comprobaciones de elegibilidad — cambian a menudo. Pero cada cambio se envía a través del mismo ciclo de PR → revisión → staging → despliegue que el código de tu aplicación principal. Una regla de descuento de una línea tarda dos semanas.

Este es un problema arquitectónico, no un problema de proceso. La lógica de negocio que cambia semanalmente no debería residir en el código que se publica trimestralmente.

LexQ separa ambos. Las reglas viven fuera de tu aplicación. Las cambias en una consola visual o a través de esta CLI. Demuestras cada cambio con simulaciones por lotes frente a datos de ejecución reales. Despliegas sin tocar tu base de código.

Cada decisión deja un rastro de auditoría completo.

Instalación

npm install -g @lexq/cli

O ejecútalo sin instalar:

npx @lexq/cli

Requiere Node.js 18+.

Inicio rápido

# 1. Authenticate
lexq auth login
# Enter your API key (create one at console.lexq.io → Management → API Keys)

# 2. Verify
lexq auth whoami

# 3. Create a policy group
lexq groups create --json '{"name":"my-policy","priority":0}'

# 4. Create a draft version
lexq versions create --group-id <GROUP_ID> --json '{"commitMessage":"v1"}'

# 5. Add a rule
lexq rules create --group-id <GROUP_ID> --version-id <VERSION_ID> --json '{
  "name": "VIP Discount",
  "priority": 0,
  "condition": {
    "type": "SINGLE",
    "field": "customer_tier",
    "operator": "EQUALS",
    "value": "VIP",
    "valueType": "STRING"
  },
  "actions": [{
    "type": "DISCOUNT",
    "parameters": {"method":"PERCENTAGE","rate":10,"refVar":"payment_amount"}
  }]
}'

# 6. Test against your data before shipping
lexq analytics dry-run --version-id <VERSION_ID> --debug --mock \
  --json '{"facts":{"customer_tier":"VIP","payment_amount":100000}}'

# 7. Deploy
lexq deploy publish --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "v1"
lexq deploy live --group-id <GROUP_ID> --version-id <VERSION_ID> --memo "Initial deploy"

Para agentes de IA — 63 herramientas MCP

LexQ está diseñado para ser nativo de IA. Toda la API del motor de políticas — las 63 herramientas — se expone a través del Protocolo de Contexto de Modelo (MCP). Claude, Cursor y otros agentes compatibles con MCP pueden crear, simular y desplegar reglas de forma autónoma, con aprobación humana antes de pasar a producción.

Claude.ai (Nube — sin instalación)

Configuración → Conectores → Añadir integración personalizada
Introduce: https://mcp.lexq.io
Inicia sesión con tu cuenta de LexQ y selecciona una clave API
Listo — 63 herramientas disponibles en cada conversación

Remoto (HTTP transmitible)

Para cualquier cliente MCP que admita servidores remotos:

{
  "mcpServers": {
    "lexq": {
      "url": "https://mcp.lexq.io"
    }
  }
}

La autenticación OAuth 2.1 es gestionada automáticamente por tu cliente.

Local (stdio)

Ejecuta LexQ CLI como un servidor MCP local:

lexq serve --mcp

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json:

{
  "servers": {
    "lexq": {
      "command": "npx",
      "args": [
        "-y",
        "@lexq/cli",
        "serve",
        "--mcp"
      ]
    }
  }
}

Requisito previo: lexq auth login debe haberse ejecutado una vez para almacenar una clave API en ~/.lexq/config.json.

Habilidades de agentes de IA

LexQ CLI incluye Habilidades de agentes de IA — documentación estructurada que los agentes leen para entender cómo usar las herramientas, no solo qué son.

skills/
├── lexq-shared/SKILL.md       Core concepts, auth, workflow
├── lexq-groups/SKILL.md       Policy groups, conflict resolution, A/B testing
├── lexq-rules/SKILL.md        Condition syntax, action types, mutex
├── lexq-simulation/SKILL.md   Dry run, batch simulation, compare
├── lexq-execution/SKILL.md    Execution history, stats, failure logs
└── lexq-recipes/SKILL.md      End-to-end recipes

.claude/CLAUDE.md              Claude Code project context
AGENTS.md                      Universal agent guide (Cursor, Windsurf, Gemini CLI, Cline)
CONTEXT.md                     Platform architecture & glossary

Después de instalar @lexq/cli, los agentes pueden leer las habilidades desde:

node_modules/@lexq/cli/skills/
node_modules/@lexq/cli/AGENTS.md
node_modules/@lexq/cli/CONTEXT.md

Comandos

lexq auth                  login | logout | whoami
lexq status                API health check
lexq serve                 Run as MCP stdio server (--mcp)
lexq groups                list | get | create | update | delete
lexq groups ab-test        start | stop | adjust
lexq versions              list | get | create | update | delete | clone
lexq rules                 list | get | create | update | delete | reorder | toggle
lexq facts                 list | create | update | delete | action-metadata
lexq deploy                publish | live | rollback | undeploy | history | detail | overview | deployable | diff
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq history               list | get | stats
lexq integrations          list | get | save | delete | config-spec
lexq logs                  list | get | action | bulk-action
lexq webhook-subscriptions list | get | save | delete | test

Opciones globales

Flag	Descripción
`--format <json\|table>`	Formato de salida (predeterminado: `json`)
`--api-key <key>`	Sobrescribir clave API almacenada
`--base-url <url>`	Sobrescribir URL base de la API
`--dry-run`	Previsualizar la solicitud HTTP sin ejecutar
`--verbose`	Mostrar detalles de solicitud/respuesta
`--no-color`	Desactivar salida en color

Configuración

La configuración se almacena en ~/.lexq/config.json:

{
  "apiKey": "YOUR_API_KEY",
  "baseUrl": "https://api.lexq.io/api/v1/partners",
  "format": "json"
}

Desarrollo

git clone https://github.com/lexq-io/lexq-cli.git
cd lexq-cli
pnpm install
pnpm build
pnpm start -- groups list

pnpm typecheck                  # Type check
pnpm lint                       # ESLint
bash tests/e2e.sh               # CLI E2E tests (requires API key)
bash tests/test-engine-api.sh   # Engine API integration tests

Licencia

Apache-2.0

LexQ