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

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

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

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

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

Звезда помогает другим людям найти Kin, а Обсуждения — место, где можно задать вопрос.

Узнать связи

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

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

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

Для Claude Code:

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

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

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

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

Kin не публикуется на crates.io. Пакет kin там — не тот проект.

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

Используйте временную копию небольшого Git-репозитория. Импорт включает всю доступную историю и может занимать значительное время и память. Shallow-клоны, субмодули и 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 и без Git

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

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

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

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

Совместимость варьируется. Проекция файловой системы имеет отдельные ограничения по платформе и инструментам. Перед использованием ознакомьтесь с примечаниями по платформе.

Сохранение состояния, присущего Kin. Удаление .kin и повторный импорт из Git не восстанавливают коммиты, обзоры или другое состояние, существовавшее только в Kin. Ознакомьтесь с заметками об импорте, восстановлении и обновлениях.

Windows. Нативная поддержка Windows x86_64 пока на раннем этапе. Приём репозитория работает: kin init импортирует Git-репозиторий и публикует графовую власть, а графовые, лексические и запросы, основанные на демоне, отвечают нативно. Прозрачная проекция файловой системы не поставляется на Windows, и доказательство полной установки ещё не охватывает MCP или рабочие процессы обзора там, поэтому WSL2 остаётся рекомендуемым путём для полного опыта Kin.

Зачем я создаю Kin

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

Вот что я строю с Kin.

Тroy

Узнать больше и внести вклад

CLI-справочник · Архитектура и подробные ограничения · Внесение вклада · Issues · Безопасность

Kin и его локальный стек, включая kin-db, распространяются по лицензии Apache-2.0. KinLab — отдельный проприетарный размещённый продукт. Публичная регистрация репозиториев всё ещё находится в разработке.