kin v0.3.4 — Semantic graph-based version control for AI-written code. Tracks entities and relations instead of file diffs, enabling blast radius analysis, shadow merge review, and MCP-powered agent context for trustworthy AI-generated software.

Kin, 사람과 AI 에이전트를 위한 코드 저장소

코드를 위한 새로운 기반.

Kin은 사람과 AI 에이전트를 위한 그래프 네이티브 코드 저장소입니다. 소스, 기록된 코드 관계, 버전 관리된 이력을 저장소 상태로 저장합니다. 그래프는 저장소 모델이며, 다른 저장소 옆에 유지되는 검색 인덱스가 아닙니다.

함수, 타입, 그리고 그들 사이의 관계는 커밋하고 브랜치하고 병합하는 데이터입니다. 정확한 소스는 바이트 단위로 보존되며, 파일시스템 프로젝션을 통해 지원되는 도구들이 일반 파일로 계속 작동할 수 있습니다.

퍼블릭 알파. 잘 알고 있는 작은 저장소로 시작하세요. 거친 부분과 호환성을 깨는 변경을 예상하세요.

빠른 시작 · 문서 · 브라우저 데모

kin impact human_bytes --file crates/kin-cli/src/commands/cache.rs --kind function --depth 1, Kin 자체 코드베이스에서 직접 호출자를 보여주며 같은 이름에 대한 git grep 검색과 나란히 표시

스타는 다른 사람들이 Kin을 찾는 데 도움이 되며, Discussions는 Kin에 대한 질문을 가져갈 곳입니다.

무엇이 연결되어 있는지 확인하세요

공유 함수를 변경하기 전에, 또 무엇을 살펴봐야 할까요? Kin을 사용하면 기록된 호출자를 조회하고 관련 코드를 탐색할 수 있습니다. CLI와 MCP 서버는 동일한 그래프를 쿼리하므로, 여러분과 여러분의 에이전트가 동일한 기록을 바탕으로 작업할 수 있습니다.

ripgrep에 대한 기록된 kin impact 쿼리로, 시그니처 변경에 대한 관련 엔티티를 보여줌

e89fff89ac9af12e8d4ce9d5fd07beb408ca730f에서 준비된 ripgrep 그래프에 기록되었습니다. 원시 실행 아티팩트는 공개되지 않습니다. 이는 워크플로를 보여주는 것이지 성능 벤치마크가 아닙니다.

Claude Code, Codex 또는 Cursor에서 사용하기

Claude Code의 경우:

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

Codex의 경우, 마켓플레이스를 추가하고 플러그인을 설치하거나, kin setup --intent agent가 ~/.codex/config.toml에 MCP 서버를 대신 작성하도록 하세요.

Cursor의 경우, MCP 서버를 수동으로 추가하세요. 정확한 스니펫은 plugins/kin-cursor를 참조하세요.

설치 후, 잘 알고 있는 작은 저장소에서 kin init .을 실행하세요. kin-setup 스킬이 나머지를 안내합니다.

Kin은 crates.io에 게시되지 않습니다. 그곳의 kin 크레이트는 관련 없는 프로젝트입니다.

빠른 시작

작은 Git 저장소의 일회용 복사본을 사용하세요. 가져오기는 도달 가능한 전체 이력을 포함하며 상당한 시간과 메모리가 소요될 수 있습니다. 얕은 클론, 서브모듈, Git LFS는 지원되지 않습니다.

1. 설치

명령 하나로, macOS, Linux, Windows, WSL에서 동일합니다. Kin을 설치하고, 발견한 AI 코딩 도구를 연결하며, 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 클라이언트를 지원합니다. VS Code의 경우 kin setup --intent editor를 사용하세요. Kin은 또한 로컬 또는 호스팅된 OpenAI 호환 모델 엔드포인트를 위한 kin agent run을 포함합니다.

클라이언트 구성 · MCP 도구 · 내장 에이전트

로컬 가져오기, 저장, 쿼리는 여러분의 머신에서 실행됩니다. 설치와 초기 임베딩 모델 다운로드에는 네트워크 접근이 필요합니다. 임베딩이 준비되기 전에는 kin locate가 어휘적 및 그래프 신호를 사용하며 누락된 벡터 커버리지를 보고합니다.

변경 검토하기

검토하려는 Git 브랜치에서 kin init을 실행한 후, 명시적 커밋 SHA를 main과 비교하세요:

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

보고서는 PASS, NEEDS ATTENTION, 또는 WOULD BLOCK을 그래프에서 도출된 영향과 뒷받침 증거와 함께 반환합니다. 이는 권고 사항입니다: 병합을 차단하거나 그래프 상태를 변경하지 않습니다. 작성자는 선언된 것이지 독립적으로 검증된 것이 아닙니다.

Git과 함께 또는 없이 Kin 사용하기

Kin은 자체 커밋, 브랜치, 병합, diff, 이력을 가지며, 그 아래에 Git이 없는 저장소에서도 마찬가지입니다. 기존 Git 저장소를 가져올 수 있으며, 지원되는 워크플로는 새 Git 저장소를 내보낼 수 있습니다.

네이티브 버전 관리 안내 · Git 상호운용성 및 내보내기 제한

알파 제한 사항

커버리지가 불완전합니다. 지원되는 언어는 엔티티와 관계로 파싱되며, 다른 파일은 콘텐츠와 이력으로 계속 사용할 수 있습니다. 빈 결과가 호출자나 의존성이 없다는 것을 증명하지는 않습니다. 컴파일러, 테스트, 리뷰를 계속 사용하세요. 언어 지원을 참조하세요.

호환성은 다양합니다. 파일시스템 프로젝션은 플랫폼과 도구별로 별도의 제한이 있습니다. 이에 의존하기 전에 플랫폼 노트를 확인하세요.

Kin 전용 상태를 보존하세요. .kin을 삭제하고 Git에서 다시 가져오면 Kin에만 존재했던 커밋, 리뷰 또는 기타 상태를 복구하지 못합니다. 가져오기, 복구, 업그레이드 노트를 읽어보세요.

Windows. 네이티브 Windows x86_64 지원은 초기 단계입니다. 저장소 승인은 작동합니다: kin init이 Git 저장소를 가져오고 그래프 권한을 게시하며, 그래프, 어휘, 데몬 기반 쿼리가 네이티브로 응답합니다. 투명한 파일시스템 프로젝션은 Windows에서 제공되지 않으며, 엔드투엔드 설치 증명은 아직 그곳에서 MCP나 리뷰 워크플로를 다루지 않으므로, 전체 Kin 경험을 위해서는 WSL2가 여전히 권장 경로입니다.

Kin을 만든 이유

저는 코딩 에이전트들이 우리가 이미 작업한 코드베이스의 일부를 계속해서 짜맞추는 것을 지켜봤습니다. 그러고 나서 저는 그들의 변경을 검토하기 위해 그 작업의 한 버전을 직접 하곤 했습니다. 저는 왜 그 구조적 이해의 더 많은 부분이 저장소 자체의 일부가 아닌지 궁금해하기 시작했습니다.

그것이 제가 Kin으로 만들고 있는 것입니다.

Troy

더 알아보고 기여하기

CLI 레퍼런스 · 아키텍처 및 상세 제한 · 기여하기 · 이슈 · 보안

Kin과 그 로컬 스택은 kin-db를 포함하여 Apache-2.0입니다. KinLab은 별도의 독점 호스팅 제품입니다. 공개 저장소 온보딩은 아직 개발 중입니다.