firelock-ai/kinAI가 작성한 코드를 위한 시맨틱 그래프 기반 버전 관리. 파일 diff 대신 엔티티와 관계를 추적하여 영향 범위 분석, 섀도 병합 리뷰, MCP 기반 에이전트 컨텍스트를 가능하게 함으로써 신뢰할 수 있는 AI 생성 소프트웨어를 지원합니다.
Kin은 AI 에이전트와 그들과 함께 만드는 사람들을 위한 그래프 네이티브 코드 저장소입니다. 소스, 기록된 코드 관계, 버전이 지정된 이력을 저장소 상태로 저장합니다. 그래프는 저장소 모델이며, 다른 저장소 옆에서 유지되는 검색 인덱스가 아닙니다.
함수, 타입, 그리고 그들 사이의 관계는 커밋하고, 브랜치하고, 병합하는 데이터입니다. 정확한 소스는 바이트 단위로 보존되며, 파일시스템 프로젝션을 통해 지원되는 도구들이 일반 파일로 계속 작동할 수 있습니다.
공개 베타. 잘 알고 있는 실제 프로젝트에서 Kin을 사용해 보세요. 거친 부분이 있을 수 있습니다.
스타는 다른 사람들이 Kin을 찾는 데 도움이 되며, Discussions는 Kin에 관한 질문을 가져갈 곳입니다.
공유 함수를 변경하기 전에, 또 무엇을 살펴봐야 할까요? Kin을 사용하면 기록된 호출자를 조회하고 관련 코드를 탐색할 수 있습니다. CLI와 MCP 서버는 동일한 그래프를 쿼리하므로, 여러분과 여러분의 에이전트가 동일한 기록을 바탕으로 작업할 수 있습니다.
e89fff89ac9af12e8d4ce9d5fd07beb408ca730f에서 준비된 ripgrep 그래프에 기록됨. 원시 실행 아티팩트는 공개되지 않습니다. 이는 워크플로를 보여주는 것이지 성능 벤치마크가 아닙니다.
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은 메모리와 여유 디스크를 확인하고, 이미 머신이 부족하다고 판단되면 수치와 함께 중단합니다. 얕은 클론은 체크아웃된 커밋만 받아들이며, 서브모듈과 Git LFS는 지원되지 않습니다. 또한 Git 훅, 스파스 체크아웃, 완료되지 않은 병합이나 리베이스도 가져오기를 중단시킵니다. kin init은 각 경우의 해결 방법을 알려주며, 새 클론은 대부분을 피할 수 있습니다.
macOS, Linux, WSL2에서는 명령 하나로 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 x64에서는 PowerShell에서 irm https://get.kinlab.dev/install.ps1 | iex로 설치합니다.
이 명령은 kin CLI를 설치하며 AI 코딩 도구를 연결하지 않습니다. Windows에서는 WSL2가
여전히 권장 경로이기 때문입니다. 베타 제한의 Windows 항목에
해당 환경에서 무엇이 동작하는지 설명되어 있습니다. 네이티브 Windows ARM64 빌드는 게시되지 않습니다. ARM64 머신에서는
x64 PowerShell에서 해당 줄을 실행하여 에뮬레이션 환경에서 x86_64 빌드를 설치하거나 WSL2를 사용하십시오.
설치 프로그램은 kin을 사용자 PATH에 추가하므로, 다음 단계 전에 exec "$SHELL" -l 대신
새 PowerShell 창을 여십시오.
다른 설치 프로그램이나 문제 해결 방법은 전체 퀵스타트를 참조하십시오.
새 프롬프트에서 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은 무엇을 제외했는지 보고합니다.
코드에 이미 존재한다는 것을 알고 있는 무언가를 찾아보세요:
kin locate "<something you already know is in this repository>"
아래의 ExactEntityName을 결과에서 가져온 심볼로 바꾸세요:
kin refs ExactEntityName
kin trace ExactEntityName
kin impact ExactEntityName
refs는 기록된 참조를 반환하고, trace는 주변 컨텍스트를 가져오며, impact는 그래프를 통해 잠재적 영향을 탐색합니다. 결과를 소스와 대조하여 확인하세요.
kin setup은 이미 발견한 AI 코딩 도구에 연결하기 전에 확인을 요청했으며, 승인하면 연결했습니다. 별도의 연결 단계는 없습니다. 다른 도구를 설치한 후에는 kin setup을 다시 실행하세요. kin setup status는 연결된 항목을 보여줍니다. Windows에서는 WSL2 내부에서 AI 도구를 연결하세요.
kin runtime status --json은 공유 CLI 및 데몬 설치를 확인하며, 정확한 소스 아이덴티티를 포함합니다. 일반 명령은 서로 일치하지 않는 쌍을 거부하며, 개발 빌드는 격리된 상태를 사용합니다. runtime installation을 참조하세요.
그래프 및 어휘 검색은 모델 없이 작동합니다. 임베딩과 리랭킹은 선택 사항이며, 해당 모델 제공자는 기본값이 none입니다. 표준 CLI 및 데몬 빌드는 외부 HTTP 모델 지원을 포함합니다. 내장 모델은 선택적 로컬 추론이 활성화된 빌드가 필요합니다.
직접 운영하는 OpenAI 호환 엔드포인트를 사용하여 임베딩 인덱스를 구축하려면:
KIN_MODEL_EMBEDDINGS_PROVIDER=external \
KIN_MODEL_EMBEDDINGS_BASE_URL=http://localhost:1234/v1 \
KIN_MODEL_EMBEDDINGS_MODEL=your-served-embedding-model kin embed
모델 엔드포인트는 각 단계에 필요한 선택된 엔티티 텍스트를 받습니다. 모델 설정은 제공자, 모델 식별자, 자격 증명 환경 변수 이름을 설명합니다.
Kin은 Claude Code, Codex, Cursor, Gemini 및 기타 MCP 클라이언트를 지원합니다. VS Code의 경우 kin setup --intent editor를 사용하세요. Kin에는 로컬 또는 호스팅된 OpenAI 호환 모델 엔드포인트를 위한 kin agent run도 포함되어 있습니다.
로컬 가져오기, 저장소, 그래프 쿼리는 사용자의 머신에서 실행됩니다. Kin을 설치하려면 네트워크 액세스가 필요하며, 기본 그래프 검색 경로는 모델 다운로드가 필요하지 않습니다. 임베딩 제공자가 선택되면 쿼리는 해당 벡터 커버리지와 누락된 부분을 보고합니다.
검토하려는 Git 브랜치에서 kin init을 실행한 후, 명시적인 커밋 SHA를 main과 비교하세요:
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
보고서는 그래프에서 도출된 영향과 뒷받침 증거와 함께 PASS, NEEDS ATTENTION, WOULD BLOCK을 반환합니다. 이는 참고용입니다: 병합을 차단하거나 그래프 상태를 변경하지 않습니다. 작성자 정보는 선언된 것이며 독립적으로 검증되지 않습니다.
Kin은 자체 커밋, 브랜치, 병합, diff, 히스토리를 갖추고 있으며, 하위에 Git이 없는 저장소에서도 마찬가지입니다. 기존 Git 저장소를 가져올 수 있고, 지원되는 워크플로에서는 새 Git 저장소를 내보낼 수 있습니다.
네이티브 버전 관리 둘러보기 · Git 상호운용성 및 내보내기 제한
커버리지는 불완전합니다. 지원되는 언어는 엔티티와 관계로 파싱되며, 그 외 파일은 콘텐츠와 히스토리로 계속 사용할 수 있습니다. 빈 결과가 호출자나 의존성이 없다는 것을 증명하지는 않습니다. 컴파일러, 테스트, 리뷰를 계속 사용하세요. 언어 지원을 참고하세요.