ktx — это контекстный слой, который учит AI-агентов правильно работать с корпоративными данными. Универсальные агенты (Claude Code, Codex, Cursor, OpenCode) спотыкаются на таких задачах: они каждый раз заново изучают базу, придумывают собственную логику метрик и выдают цифры, не совпадающие с утверждёнными нормами. Обычные семантические слои (вроде dbt или MetricFlow) тоже не панацея — они требуют ручного обновления и не впитывают знания компании.
ktx автоматизирует процесс. Он собирает информацию из вики, структурирует её, удаляет дубликаты и помечает противоречия для проверки человеком. Затем инструмент анализирует таблицы: собирает метаданные, паттерны использования, находит колонки, по которым можно соединять данные, и аннотирует источники — агенты начинают писать точные запросы. На основе этих данных строится семантический слой с графом соединений, который сам решает проблемы chasm и fan traps — это ловушки, когда связи между таблицами неочевидны или ведут к дублированию строк. В результате агенты получают метрики по декларативным запросам, а не переписывают каноничный SQL каждый раз.
ktx работает поверх SQL-хранилищ: PostgreSQL, Snowflake, BigQuery, ClickHouse, MySQL, SQL Server, SQLite. Интегрируется с dbt, MetricFlow, LookML, Looker, Metabase и Notion. Данные с базы только читаются — инструмент никогда не пишет в хранилище. Вся работа идёт локально, ни схема, ни результаты запросов не отправляются на внешний сервер (кроме вызова настроенного LLM-провайдера). Поддерживаются Anthropic API, Google Vertex AI, AI Gateway и локальная сессия Claude Code.
Установка — npm install -g @kaelio/ktx. После команды ktx setup проект готов: проверяет соединения, создаёт контекст, настраивает интеграцию с агентом. Полезные команды: ktx context status, ktx status, ktx ingest, ktx sl "revenue", ktx wiki "refund policy", ktx mcp start. В структуре проекта есть конфиг ktx.yaml, папки semantic-layer/ и wiki/, которые можно коммитить, и .ktx/ с локальными секретами (git-игнорируется). Проект собирает анонимную телеметрию только с интерактивного CLI (без путей, хостов, SQL, названий схем и ошибок), отключить можно в настройках. Код распространяется под Apache License 2.0.