kin v0.3.3

Новая основа для кода.

Kin — это графовый репозиторий кода для людей и ИИ-агентов. Он хранит исходный код, зафиксированные связи между кодом и версионированную историю как состояние репозитория. Граф — это модель репозитория, а не поисковый индекс, поддерживаемый рядом с другим репозиторием.

Функции, типы и связи между ними — это данные, которые вы коммитите, ветвите и сливаете. Точный исходный код сохраняется байт в байт, а проекции файловой системы позволяют поддерживаемым инструментам продолжать работать с обычными файлами.

Публичная альфа. Начните с небольшого репозитория, который вы хорошо знаете. Ожидайте шероховатостей и ломающих изменений.

Быстрый старт · Документация · Демо в браузере

Звезда помогает другим людям найти Kin, а Discussions — это место, куда можно прийти с вопросом о нём.

Посмотрите, что с чем связано

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

Записано на подготовленном графе ripgrep на e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Сырые артефакты запуска не публичны. Это иллюстрирует рабочий процесс, а не бенчмарк производительности.

Используйте его из Claude Code, Codex или Cursor

Для Claude Code:

/plugin marketplace add firelock-ai/kin
/plugin install kin@kin

Для Codex добавьте маркетплейс и установите плагин, или позвольте kin setup --intent agent прописать MCP-сервер в ~/.codex/config.toml за вас.

Для Cursor добавьте MCP-сервер вручную; точный фрагмент смотрите в plugins/kin-cursor.

После установки запустите kin init . в небольшом репозитории, который вы хорошо знаете; навык kin-setup проведёт вас через всё остальное.

Kin не публикуется на crates.io. Крейт kin там — это не связанный проект.

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

Используйте одноразовую копию небольшого Git-репозитория. Импорт включает всю его достижимую историю и может занять существенное время и память. Неглубокие клоны, подмодули и Git LFS не поддерживаются.

1. Установка

Одна команда, и она одинакова на macOS, Linux, Windows и WSL. Она устанавливает Kin, подключает найденные инструменты ИИ-кодинга и требует Node.js 20 или новее:

npx -y @kinlab/kin setup

На машине без Node вместо этого запустите установщик. get.kinlab.ai и get.kinlab.dev отдают один и тот же скрипт:

curl -fsSL https://get.kinlab.dev/install | sh

В любом случае перезагрузите оболочку отдельной командой, потому что установка помещает kin в ~/.kin/bin и добавляет этот каталог в профиль вашей оболочки для новых сессий:

exec "$SHELL" -l

Для Windows PowerShell, других установщиков или устранения неполадок смотрите полный быстрый старт.

2. Инициализация репозитория

В новой командной строке замените путь ниже:

cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status

kin overview показывает сущности, которые импортировал Kin. kin status показывает, что было принято, и состояние рабочего дерева относительно этого. kin graph status сообщает о живом графе запросов демона и покрытии. Незакоммиченные и неотслеживаемые изменения не являются частью импортированной истории Git; kin init сообщает, что он пропустил.

3. Задайте вопрос, который можно проверить

Поищите что-то, о чём вы уже знаете, что оно есть в коде:

kin locate "<something you already know is in this repository>"

Замените ExactEntityName ниже на символ из результата:

kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName

refs возвращает зафиксированные ссылки, trace добавляет близкий контекст, а impact исследует потенциальные последствия через граф. Сверьте результаты с исходным кодом.

4. Подключите вашего агента

Подготовьте локальные эмбеддинги, затем настройте обнаруженные MCP-клиенты:

kin embed &&
kin setup --intent agent &&
kin setup status --json

Kin поддерживает Claude Code, Codex, Cursor, Gemini и другие MCP-клиенты. Используйте kin setup --intent editor для VS Code. Kin также включает kin agent run для локальных или размещённых эндпоинтов моделей, совместимых с OpenAI.

Конфигурация клиента · Инструменты MCP · Встроенный агент

Локальные импорты, хранение и запросы выполняются на вашей машине. Установка и первоначальная загрузка модели эмбеддингов требуют доступа к сети. Пока эмбеддинги не готовы, kin locate использует лексические и графовые сигналы и сообщает об отсутствующем векторном покрытии.

Проверьте изменение

После запуска kin init на ветке Git, которую вы хотите проверить, сравните явные SHA коммитов с main:

kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"

Отчёт возвращает PASS, NEEDS ATTENTION или WOULD BLOCK, с выведенным из графа влиянием и подтверждающими доказательствами. Он носит рекомендательный характер: он не блокирует слияние и не меняет состояние графа. Авторство заявляется, а не проверяется независимо.

Используйте Kin с Git или без него

У Kin есть собственные коммиты, ветки, слияния, диффы и история, в том числе в репозиториях без Git под ними. Существующие Git-репозитории можно импортировать, а поддерживаемые рабочие процессы могут экспортировать новый Git-репозиторий.

Руководство по нативному контролю версий · Совместимость с Git и ограничения экспорта

Ограничения альфы

Покрытие неполное. Поддерживаемые языки разбираются на сущности и связи; остальные файлы остаются доступны как содержимое и история. Пустой результат не доказывает, что вызывающих или зависимостей нет. Продолжайте использовать ваш компилятор, тесты и ревью. Смотрите поддержку языков.