zoo-kcl-check-cli

Локальные проверки Zoo / KittyCAD KCL: форматирование, синтаксис, стиль, ошибки выполнения и ограничения эскизов. Работает без сети, Zoo-аккаунта и API-токенов.

Выполнение использует mock CAD-движок. Успешная проверка не подтверждает корректность 3D-геометрии — её нужно проверять в Zoo.

Установка

pipx install zoo-kcl-check-cli

Также доступны pip install zoo-kcl-check-cli и uv tool install zoo-kcl-check-cli. Требуется Python 3.11–3.14. Пакет в PyPI.

Использование

kcl-check lint main.kcl
kcl-check execute main.kcl
kcl-check sketches main.kcl
kcl-check format main.kcl --write

Вместо файла можно передать папку:

kcl-check lint .
kcl-check execute .
kcl-check sketches .
kcl-check format . --check

lint и format обрабатывают .kcl рекурсивно, пропуская символические ссылки. execute и sketches запускают default_file из project.toml или main.kcl. Импорты соседних KCL-файлов поддерживаются.

Предупреждения тоже считаются неуспехом. Команда sketches завершается неуспешно при недоопределённых или конфликтующих эскизах и неполном отчёте.

Параметры каждой команды доступны через kcl-check COMMAND --help.

Вывод

По умолчанию вывод текстовый. Диагностика идёт в stderr, результаты и отчёты — в stdout. Ошибки движка включают фрагмент кода и указатель на проблемное место, если эта информация доступна.

Для скриптов, CI и coding-агентов:

kcl-check execute main.kcl --json

--json возвращает один объект в stdout, в том числе при ошибках. Основные поля: ok, exit_code, diagnostics, sketches, formatting. Полный формат описан в контракте результата.

Все команды поддерживают --timeout SECONDS; по умолчанию — 60 секунд на всю команду.

Скиллы для агентов

• kcl-modeling — правила моделирования и приёмы работы с KCL.
• kcl-check — установка CLI, запуск проверок и разбор результатов.

npx skills add gavroman/zoo-kcl-check --skill kcl-modeling --skill kcl-check

Разработка

Окружение, тесты и сборка. Ошибки и предложения — в GitHub Issues.

Лицензия

MIT.