LexQ CLI

Платформа принятия решений для инженерных команд. CLI и MCP-сервер для LexQ — выносите бизнес-правила из вашего конвейера развертывания, проверяйте каждое изменение с помощью симуляции и выпускайте обновления без git push.

Веб-сайт · Документация · Консоль

npm Лицензия

Почему LexQ?

Ваши бизнес-правила — ценообразование, акции, логика комиссий, проверки на соответствие требованиям — меняются часто. Но каждое изменение проходит через тот же цикл PR → ревью → стейджинг → развертывание, что и основной код приложения. Однострочное правило скидки занимает две недели.

Это архитектурная проблема, а не проблема процесса. Бизнес-логика, которая меняется еженедельно, не должна находиться в коде, который выпускается ежеквартально.

LexQ разделяет их. Правила живут вне вашего приложения. Вы меняете их в визуальной консоли или через этот CLI. Вы подтверждаете каждое изменение с помощью пакетной симуляции на реальных данных выполнения. Вы развертываете без изменения кодовой базы.

Каждое решение оставляет полный след аудита.

Установка

npm install -g @lexq/cli

Или запустите без установки:

npx @lexq/cli

Требуется Node.js 18+.

Быстрый старт

# 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"

Для ИИ-агентов — 63 инструмента MCP

LexQ разработан как AI-native решение. Весь API движка политик — все 63 инструмента — предоставляется через протокол Model Context Protocol. Claude, Cursor и другие совместимые с MCP агенты могут создавать, симулировать и развертывать правила автономно, с одобрением человека перед запуском в продакшн.

Claude.ai (Облако — без установки)

Настройки → Коннекторы → Добавить пользовательскую интеграцию
Введите: https://mcp.lexq.io
Войдите в свою учетную запись LexQ и выберите API-ключ
Готово — 63 инструмента доступны в каждом диалоге

Удаленно (потоковый HTTP)

Для любого MCP-клиента, поддерживающего удаленные серверы:

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

Аутентификация OAuth 2.1 обрабатывается вашим клиентом автоматически.

Локально (stdio)

Запустите LexQ CLI как локальный MCP-сервер:

lexq serve --mcp

Claude Desktop

Добавьте в 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"
      ]
    }
  }
}

Предварительное условие: необходимо один раз выполнить lexq auth login для сохранения API-ключа в ~/.lexq/config.json.

Навыки ИИ-агентов

LexQ CLI поставляется с навыками ИИ-агентов — структурированной документацией, которую агенты читают, чтобы понять, как использовать инструменты, а не только что они собой представляют.

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

После установки @lexq/cli агенты могут читать навыки из:

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

Команды

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

Глобальные опции

Флаг	Описание
`--format <json\|table>`	Формат вывода (по умолчанию: `json`)
`--api-key <key>`	Переопределить сохраненный API-ключ
`--base-url <url>`	Переопределить базовый URL API
`--dry-run`	Предварительный просмотр HTTP-запроса без выполнения
`--verbose`	Показать детали запроса/ответа
`--no-color`	Отключить цветной вывод

Конфигурация

Конфигурация хранится в ~/.lexq/config.json:

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

Разработка

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

Лицензия

Apache-2.0

LexQ