kin v0.3.4
Семантическая система записи для программного обеспечения, написанного ИИ: граф сущностей и отношений, а не различия в файлах.
Новая основа для кода.
Kin — это графовый репозиторий кода для ИИ-агентов и людей, которые с ними работают. Он хранит исходный код, зафиксированные связи между кодом и версионированную историю как состояние репозитория. Граф — это модель репозитория, а не поисковый индекс, поддерживаемый рядом с другим репозиторием.
Функции, типы и связи между ними — это данные, которые вы коммитите, ветвите и сливаете. Точный исходный код сохраняется байт в байт, а проекции файловой системы позволяют поддерживаемым инструментам продолжать работать с обычными файлами.
Публичная бета. Попробуйте Kin на реальном проекте, который вы хорошо знаете. Ожидайте шероховатостей.
Быстрый старт · Документация · Демо в браузере
Звезда помогает другим людям найти Kin, а Discussions — место, где можно задать о нём вопрос.
Узнайте, что связано
Прежде чем менять общую функцию, что ещё стоит проверить? Kin позволяет найти её зафиксированных вызывающих и исследовать связанный код. CLI и MCP-сервер обращаются к одному и тому же графу, так что вы и ваш агент можете работать с одной и той же записью.
Записано на подготовленном графе ripgrep на коммите e89fff89ac9af12e8d4ce9d5fd07beb408ca730f. Сырые артефакты запуска не публичны. Это иллюстрирует рабочий процесс, а не бенчмарк производительности.
Используйте из Claude Code, Codex или Cursor
Для Claude Code:
/plugin marketplace add kinlab-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 там — это не связанный с ним проект.
Быстрый старт
Начните со свежего полного клона проекта, который вы хорошо знаете. kin init читает вашу историю Git, не изменяя её и ваши отслеживаемые файлы. Он хранит своё хранилище вне вашего рабочего каталога, в ~/.kin/stores, и ничего не записывает в репозиторий; kin store path выводит, где находится хранилище для рабочего каталога. По умолчанию он сначала принимает извлечённый коммит, так что вопросы получают ответы, как только это дерево прочитано, а затем импортирует в фоновом режиме с низким приоритетом каждый коммит, до которого доходят ваши ветки и теги; kin init --history full импортирует всю историю сразу, а --history none никогда её не импортирует. Импорт истории требует времени, памяти и диска, которые растут вместе с историей, а не с размером рабочего каталога. Перед запуском kin init проверяет память и свободное место на диске и останавливается с указанием цифр, когда уже может определить, что машине не хватает ресурсов. Неполный (shallow) клон принимает только свой извлечённый коммит, а подмодули и Git LFS не поддерживаются, также импорт останавливают Git-хуки, разреженный (sparse) рабочий каталог или незавершённое слияние либо перебазирование. kin init называет решение для каждого случая, а свежий клон позволяет избежать большинства из них.
1. Установка
В macOS, Linux и WSL2 одна команда устанавливает 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 x64 установите из PowerShell командой irm https://get.kinlab.dev/install.ps1 | iex.
Она устанавливает CLI kin и не подключает инструменты ИИ-кодирования, поскольку WSL2 остаётся
рекомендуемым путём в Windows. Пункт Windows в разделе Ограничения бета-версии
описывает, что там работает. Нативная сборка для Windows ARM64 не публикуется. На машине ARM64 запустите
эту строку из x64 PowerShell, чтобы установить сборку x86_64 под эмуляцией, или используйте WSL2.
Установщик добавляет kin в ваш пользовательский PATH, поэтому перед следующим шагом откройте новое окно PowerShell вместо
exec "$SHELL" -l.
О других установщиках или устранении неполадок см. полное руководство по быстрому старту.
2. Инициализируйте репозиторий
В новой командной строке клонируйте репозиторий с помощью Kin:
kin clone https://github.com/pallets/itsdangerous
Или инициализируйте тот, который у вас уже есть, заменив путь ниже:
cd /path/to/your/repository &&
kin init . &&
kin overview &&
kin status
Оба заканчиваются следующей командой для запуска — вопросом kin refs о функции в этом
репозитории. Они также подключают Codex CLI и Grok CLI к нему, если вы разрешили это при настройке,
поскольку эти клиенты хранят одну запись, указывающую на репозиторий.
В Windows PowerShell 5.1 нет &&, поэтому в нативной Windows запускайте те же команды по одной
и останавливайтесь, если какая-то из них завершится ошибкой:
cd C:\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 исследует потенциальные последствия через граф. Сверяйте результаты с источником.