업데이트로 돌아가기
New releaseSep 4, 2026

kin v0.6.4

AI가 작성한 소프트웨어를 위한 기록 시스템입니다. 엔티티, 관계, 변경 사항, 출처(provenance)를 영구적으로 기록하는 그래프로, 인간과 AI 에이전트가 변경 사항이 병합되기 전에 그 변경이 무엇과 연관되는지 확인할 수 있습니다. 오늘날 Git과 나란히 사용됩니다.

공유

Kin, the semantic system of record for AI-written software

diff는 변화가 아니다.

License: Apache-2.0 Latest release kinlab.ai

AI 에이전트는 팀이 변경 사항이 무엇을 건드리는지, 이전 수정을 되돌리는지, 그 영향이 어디까지 미치는지 파악하는 것보다 더 빠르게 변경 사항을 작성할 수 있습니다. Git은 파일과 라인 기록을 저장합니다. Kin은 소프트웨어 자체를 엔티티, 관계, 변경 사항, 출처의 그래프로 기록한 다음, 인간과 에이전트에게 쿼리하고 검토할 수 있는 하나의 의미론적 권위를 제공합니다. 변경 사항이 건드리는 것은 병합 전에 드러나며, 에이전트는 저장소를 다시 읽는 대신 정확한 컨텍스트에서 작업합니다.

Kin은 AI가 작성한 소프트웨어를 위한 의미론적 시스템 오브 레코드입니다. 초기 알파 단계로, 현재 로컬 CLI, 데몬, MCP 서버, 검토 표면, 그래프 기반 파일시스템 프로젝션으로 사용할 수 있습니다. 1.0 이전 버전이므로 거친 부분과 파괴적 변경이 있을 수 있습니다. 중요한 워크플로우에 도입하기 전에 최신 안정 릴리스현재 제한 사항을 확인하세요.

실제 저장소에서 확인하기

ripgrep의 한 줄 시그니처 변경은 diff에서 무해해 보입니다. 컴파일러가 실행되기 전에 kin impact에 물어보면, 그 편집이 도달하는 대상을 이름으로 알려줍니다. 변경된 시그니처의 호출자가 먼저 나오고, 그 다음 그 호출자들이 뒤에서 끌어오는 모든 것이 나옵니다.

kin impact on ripgrep: a one-line signature edit, and Kin surfaces the entities it affects before a compiler runs

ripgrep 커밋 e89fff89ac9af12e8d4ce9d5fd07beb408ca730f에서 준비된 그래프에 대해 기록되었습니다. 한 줄 시그니처 편집으로, Kin은 컴파일러가 실행되기 전에 영향을 받는 엔티티를 표면화합니다. 그래프는 미리 구축되었습니다. 컴파일러는 실행되지 않았습니다. 정확한 명령: kinlab.ai/proof. 원시 실행 디렉터리는 아직 공개되지 않았으므로, 이는 감사할 수 있는 추적이 아니라 다시 실행할 수 있는 레시피입니다.

Kin은 변경 사항이 건드리는 것을 표면화합니다. 변경 사항이 올바른지 여부는 컴파일러, 테스트, 검토에 달려 있습니다. 그래프는 kin init에 의해 미리 구축되며, 구축하는 것이 비용이 많이 드는 부분입니다. 그 후에는 영향 질문에 트리를 다시 읽는 것이 아니라 그래프 진실에서 답합니다.

스택

Kin은 몇 가지 명확한 공개 표면을 가진 하나의 시스템입니다:

표면기능
kin의미론적 시스템 오브 레코드: CLI, 데몬, 그래프 수명주기, MCP, 검토, 출처, Git 공존.
kin-vfs그래프가 소유한 파일을 일반 파일시스템 호출을 통해 프로젝션하여 기존 도구가 계속 파일을 사용할 수 있게 합니다.
kin-editor엔티티 탐색기, 의미론적 검색, 추적, 검토, 이름 변경 표면에 대한 VS Code 액세스.
Kin MCPAI 에이전트를 위한 타입화된 그래프 도구로, kin에 번들되어 kin mcp start로 실행됩니다.
KinLab호스팅된 협업 및 제어 평면. 공개 저장소 연결은 아직 첫 실행 흐름이 아닙니다.

구성 요소가 어떻게 맞물리는가

Kin은 AI가 작성한 소프트웨어를 위한 의미론적 시스템 오브 레코드이며, 아래 지도의 모든 것은 그 권위에 도달하거나 이를 지원합니다. 인간과 AI 에이전트는 CLI, 번들된 MCP 서버, 또는 VS Code 확장을 통해 들어옵니다. 세 가지 모두 동일한 데몬에 요청하며, 데몬은 트리를 다시 읽는 대신 그래프 권위에서 답합니다. kin-vfs는 동일한 그래프를 일반 파일시스템 호출을 통해 다시 프로젝션하여 편집기, 컴파일러, 빌드 시스템이 계속 파일을 볼 수 있게 합니다. Git은 답 경로가 아니라 가져오기/내보내기 경계로 그래프 옆에 있으며, KinLab은 동일한 권위 위의 호스팅된 계층입니다.```mermaid flowchart TD people["Humans and AI agents"]

subgraph surfaces["Access surfaces"]
    cli["kin CLI"]
    mcp["Kin MCP server"]
    editor["kin-editor for VS Code"]
end

daemon["kin daemon"]
authority["Graph authority<br/>entities, relations, changes, provenance"]
db["kin-db<br/>graph storage, snapshots,<br/>index, text and vector search"]
prims["kin-model, kin-blobs, kin-search,<br/>kin-vector, kin-infer, kin-lsp"]
vfs["kin-vfs<br/>transparent file projection"]
tools["Editors, compilers, build systems"]
git["Git<br/>import and export boundary"]
kinlab["KinLab<br/>hosted collaboration and control plane"]

people --> cli
people --> mcp
people --> editor
cli --> daemon
mcp --> daemon
editor --> daemon
daemon --> authority
authority --> db
db --> prims
authority <-->|"kin init imports, kin git export"| git
authority -->|"publish and sync"| kinlab
authority --> vfs
vfs --> tools
이 표면 아래에는 시스템을 구성하는 계층들이 있습니다:

| 계층 | 역할 |
| --- | --- |
| **[kin-db](https://github.com/firelock-ai/kin-db)** | 그래프 저장소, 스냅샷, 인덱싱, 텍스트 검색 및 벡터 검색. |
| **[kin-model](https://github.com/firelock-ai/kin-model)** | 스택 전반에 걸쳐 공유되는 표준 유형 및 도메인 모델. |
| **[kin-blobs](https://github.com/firelock-ai/kin-blobs)** | 콘텐츠 주소 지정 방식의 블롭 저장소. |
| **[kin-search](https://github.com/firelock-ai/kin-search)** | 어휘 검색 기본 요소 및 단계적 검색. |
| **[kin-vector](https://github.com/firelock-ai/kin-vector)** | 벡터 및 최근접 이웃 기반 하부 구조. |
| **[kin-infer](https://github.com/firelock-ai/kin-infer)** | 추론 및 임베딩 하부 구조. |
| **[kin-lsp](https://github.com/firelock-ai/kin-lsp)** | 의미 계층에 공급되는 언어 서버 강화 기능. |

이들은 별도의 제품이 아니라 하나의 시스템을 구성하는 구현 계층으로, 새 사용자가
조립할 필요가 없습니다. 이 중 어느 것도 별도로 설치되지 않습니다.

## 오픈 소스와 Kin 생태계

Kin의 핵심은 Apache-2.0 라이선스의 오픈 소스입니다: [kin](https://github.com/firelock-ai/kin),
[kin-db](https://github.com/firelock-ai/kin-db), [kin-vfs](https://github.com/firelock-ai/kin-vfs),
그리고 [kin-editor](https://github.com/firelock-ai/kin-editor), 여기에 지원 라이브러리인
kin-model, kin-blobs, kin-search, kin-vector, kin-infer, kin-lsp 및
kin-actions가 포함됩니다.

[KinLab](https://kinlab.ai)은 이 오픈 코어 위에 구축된 독점 제품입니다: 앞서 설명한
호스팅형 협업 및 컨트롤 플레인 계층입니다.

동일한 경계가 벤치마크 작업 공유 방식에도 적용됩니다. [벤치마크
사양 및 독립형, 의존성 없는 번들 검증기](https://github.com/firelock-ai/kin-bench-spec)는
공개되어 있어, 이를 생성한 시스템에 접근하지 않고도 주장을 검증할 수 있습니다.
봉인된 증거 번들을 생성하는 러너 및 증명 인프라(오케스트레이션, 고정 릴리스 증명 게이트,
호스팅형 측정 환경)는 현재 비공개로 유지됩니다. 사양과 검증기가 먼저 공개되고,
러너는 나중에 공개될 수 있습니다.

## 가장 짧은 그래프 기반 경로

다섯 개의 명령어, 그리고 마지막 명령어가 답입니다:```sh
curl -fsSL https://get.kinlab.dev/install | sh
exec "$SHELL" -l
cd /path/to/your/repository
kin init .
kin locate "where are webhook retries handled"

kin init는 느린 단계이며 나머지 모든 것을 가능하게 하는 단계입니다. 이 단계는 Git 히스토리를 그래프에 통합하며, 이후의 모든 답변은 트리를 다시 읽는 대신 해당 그래프에서 나옵니다. 오늘 npm이 제공하는 릴리스를 기준으로 CPU 4개와 8GiB 메모리를 갖춘 새 Debian 12 컨테이너에서 측정했을 때, 설치 프로그램은 4초가 걸렸고, kin init는 커밋 1,983개가 있는 503개 파일 저장소에서 139초가 걸렸으며, 첫 번째 kin locate는 데몬이 콜드 스타트하는 동안 6.7초 만에 응답했고, 이후 웜 상태에서는 71밀리초 만에 응답했습니다. 이는 한 번의 타이밍 측정이 아니라 한 세션에서 각각 별도로 측정한 구간이며, 히스토리가 더 깊은 저장소는 더 오래 걸립니다.

kin init 이후에 에이전트를 연결하세요. 그 전이 아닙니다. 이 섹션의 나머지 부분은 각 단계의 세부 사항을 포함한 동일한 경로입니다.

1. Kin 설치 및 구성

macOS 또는 Linux에서:```sh curl -fsSL https://get.kinlab.dev/install | sh exec "$SHELL" -l kin setup --intent agent

`kin setup --intent editor`를 VS Code 경로에 사용하세요. 결과로 생성된
머신이 읽을 수 있는 상태 점검 목록은 `kin setup status --json`으로 확인합니다.

설치 프로그램은 [최신 안정 릴리스](https://github.com/firelock-ai/kin/releases/latest)를 확인하고,
게시된 SHA-256 체크섬을 검증한 뒤, 관리되는 바이너리를 `~/.kin` 아래에
설치하고 설정을 시작합니다. 명시적인 `agent` 의도를 실행하면 감지된 지원 클라이언트를 위해
내장 MCP 서버가 구성됩니다. MCP 구성 없이 CLI 및 파일시스템 사용만 하려면 `--intent local`을,
VS Code 경로에는 `--intent editor`를 사용하세요.

설정으로 관리되는 통합만 제거하려면 `kin setup uninstall`을 실행하세요. 기본 관리 루트(`~/.kin`)의 경우
`kin setup uninstall --all`은 모든 Kin 데몬을 중지하고, 레거시 설치 프로그램 PATH 블록을 정확히 제거하며,
관리되는 설치 디렉터리를 재귀적으로 삭제합니다(`--dry-run`으로 미리 볼 수 있음). 사용자 지정 `KIN_HOME`은
재귀적으로 삭제되지 않습니다. 먼저 원장 범위의 제거를 실행한 다음 해당 디렉터리를 명시적으로 검토하고 제거하세요.
수정된 설정 소유 슬라이스는 `--force`를 추가하지 않으면 전체 제거를 차단하므로, 제거 시 사용자가 편집한
클라이언트 또는 셸 구성을 조용히 덮어쓰지 않습니다. Windows에서는 CLI가 실행 중인 프로세스가 종료된 직후
잠긴 설치 디렉터리의 삭제를 예약합니다. Windows는 의도적으로 비활성 상태의 현재 사용자 전용 형제 권한 사이드카 하나를
유지합니다. 이 잠금 ID를 안정적으로 유지하면 충돌이나 동시 설치로 인해 두 개의 독립적인 변경 권한이 생성되는 것을
방지할 수 있습니다. CLI와 JSON 결과는 잔여 바이트가 0이라고 주장하지 않고 이 유지된 조정 메타데이터를 공개합니다.

수동 설치의 경우 각 아카이브와 해당 `.sha256` 파일은
`https://github.com/firelock-ai/kin/releases/latest/download/` 아래에 게시됩니다. 이동식 자산 이름은
`kin-macos-aarch64`, `kin-macos-x86_64`, `kin-linux-aarch64`,
`kin-linux-x86_64`, `kin-windows-x86_64`입니다. macOS 및 Linux 아카이브에는 `.tar.gz` 접미사를,
Windows에는 `.zip` 접미사를 사용하세요(최신 릴리스 페이지에 표시된 대로). Windows zip은
PowerShell 설치 프로그램과 npm 런처가 가져오는 파일이기도 합니다.

npm 진입점은 동일한 공개 릴리스 채널을 확인합니다.```sh
npm install -g @kinlab/kin@latest

전역 설치에는 쓰기 가능한 npm 프리픽스가 필요합니다. 프리픽스가 root 소유이고 사용자가 root가 아닌 경우, Kin이 실행되기 전에 npm이 EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@kinlab' 오류를 반환합니다. 이는 기본 사용자가 root가 아닌 컨테이너 내부에서 흔히 발생하는 경우입니다. 제로 설치 경로인 npx -y @kinlab/kin setup --intent agent --no-interactive를 사용하거나, 프리픽스를 사용자가 소유한 위치로 옮기고 PATH에 추가하세요:```sh npm config set prefix ~/.npm-global export PATH="$HOME/.npm-global/bin:$PATH" # add this to your shell profile too npm install -g @kinlab/kin@latest

사용자 접두사는 대화형 셸의 `PATH`에만 있으며 다른 곳에는 없습니다. 스크립트, CI 단계, `docker exec`, 에이전트 클라이언트는 이를 상속받지 않으므로, 이러한 경우에는 단순한 `kin` 대신 바이너리의 절대 경로를 지정하세요. 등록 형식은 [에이전트와 함께 사용](#works-with-your-agent)을 참조하세요.

Homebrew 탭은 동일한 릴리스 채널을 추적합니다:```sh
brew install firelock-ai/kin/kin

탭의 포뮬러는 수동으로 유지 관리되지 않고 생성됩니다. 버전과 플랫폼별 SHA-256은 탭 저장소의 update-formula.yml에 의해 각 Kin 릴리스에서 다시 생성되며, 릴리스 자체가 보내는 디스패치에 따라 실행되고, 6시간마다 동기화되어 놓친 디스패치를 자가 복구합니다. 그래서 Homebrew가 검증하는 체크섬은 아카이브 옆에 게시된 것과 동일하며, 별도로 관리되는 사본이 아닙니다. 다른 설치 경로와 마찬가지로 kin --version으로 설치된 것을 확인하세요.

Windows에서는 PowerShell에서 irm https://get.kinlab.dev/install.ps1 | iex를 실행하세요. 네이티브 Windows x86_64 지원은 초기 단계입니다. 저장소 승인은 작동합니다. kin init는 Git 저장소를 가져와 그래프 권한을 게시하며, 그래프, 어휘, 데몬 기반 쿼리는 네이티브로 응답합니다. 투명 파일 시스템 프로젝션은 Windows에서 제공되지 않으며, 엔드투엔드 설치 검증은 아직 Windows의 MCP 또는 리뷰 워크플로를 포함하지 않으므로, 전체 Kin 경험을 위해서는 WSL2가 여전히 권장 경로입니다. Windows 설치 경로를 선택하기 전에 아래의 플랫폼 및 성숙도를 읽어보세요.

2. 기존 저장소를 그래프 진실로 승인하기```sh

cd /path/to/your/repository kin init .

감지된 Git 저장소에서 `kin init`은(는) 도달 가능한 전체 히스토리, refs, 원시 객체, 정확한 작업 트리, 그리고 허용 정책을 repository-v6 그래프 권위에 원자적으로 수용합니다. 커밋되지 않은 편집, 스테이징된 변경, 또는 추적되지 않은 파일이 있는 작업 트리도 수용합니다: `kin init`은(는) 커밋된 상태를 수용하고 수용하지 않은 내용을 공개합니다. 정확한 HEAD 스냅샷이나 원시 파일시스템 의미론적 재구축을 대체하지 않습니다. 지원되는 저장소-로컬 원격 URL, refspec, 브랜치 추적, 푸시 기본값은 Kin의 Git 공존 구성에 봉인됩니다. 안전하지 않거나, 모호하거나, 지원되지 않는 전송 설정은 게시 전에 실패-폐쇄됩니다.

수용은 또한 해당 히스토리의 모든 지원되는 엔티티-소스 파일에 대한 의미론적 엔티티 및 관계 계층을 도출하며, `kin init`은(는) 커밋한 지속적이고 세대-바운드된 개수를 보고합니다. `kin status`는 해당 저장소 권위 뷰를 보고합니다. `kin graph status`는 별도로 데몬의 변경 가능한 라이브 쿼리 그래프를 보고하며, 여기에는 이후에 도출된 강화가 포함될 수 있습니다.
쿼리 표면은 존재할 때 그래프 소유의 강화를 소비하고, 원시 파일 검색 뒤에 그 격차를 숨기는 대신 그 부재를 보고합니다.

#### 어떤 파일이 엔티티가 되는가

"지원되는 엔티티-소스 파일"은 Kin의 언어 어댑터 중 하나가 주장하는 파일을 의미합니다. 어댑터 레지스트리가 전체 집합이며, 저장소의 모든 파일은 이를 통해 해석됩니다:

| 언어 | 확장자 |
| --- | --- |
| TypeScript | `.ts`, `.tsx` |
| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` |
| Python | `.py`, `.pyi` |
| Go | `.go` |
| Java | `.java` |
| Rust | `.rs` |
| C | `.c`, `.h` |
| C++ | `.cpp`, `.hpp`, `.cc`, `.cxx` |
| C# | `.cs` |
| Ruby | `.rb` |
| PHP | `.php` |
| Swift | `.swift` |
| Kotlin | `.kt`, `.kts` |
| HCL / Terraform | `.tf`, `.tfvars` |

`.h` 헤더는 내용이 그렇게 나타내면 C++로 읽히므로, C++ 프로젝트는 C 문법에 네임스페이스와 템플릿을 잃지 않습니다.

그 외의 모든 것은 콘텐츠로 수용되어 히스토리와 텍스트로 쿼리 가능한 상태를 유지하지만, 엔티티와 관계로 파싱되지는 않습니다. 여기에는 Markdown, HTML 및 CSS, SQL, YAML, JSON 및 TOML, 셸 스크립트, Objective-C, Scala, Elixir, Dart, Lua, R, Zig, Haskell, Nix가 포함됩니다. 언어가 해당 목록에 있다면 `locate`와 `refs`는 그 안에서 기호를 찾지 못합니다.

### 3. 그래프에 실제 질문을 하세요```sh
kin locate "where are webhook retries handled"
kin refs ExactEntityName
kin trace ExactEntityName
kin overview

ExactEntityNamelocate가 반환한 심볼로 바꾸세요. locate는 의도와 관련된 엔티티를 찾고, refs는 그래프가 소유한 호출자/임포터와 참조를 보여주며, trace는 초점 엔티티와 주변의 의미적 컨텍스트를 반환합니다. 임베딩이 완료되면, 구성된 AI 에이전트는 벡터 기반 semantic_locate 도구를 사용할 수 있습니다. get_context_pack, find_references, trace_data_flow는 그래프 이웃을 직접 노출합니다.

Admission은 의미적 엔티티를 도출하며, 벡터는 도출하지 않습니다. kin embed를 실행하여 해당 엔티티에 로컬 벡터 유사성을 추가하고, kin graph status로 적용 범위를 확인하세요.

에이전트와 함께 사용하기

Kin은 자체 에이전트를 제공하며, 에이전트 작업에는 이 경로를 권장합니다. kin agent run은 OpenAI 호환 엔드포인트를 구동하므로, LM Studio, Ollama, llama.cpp 또는 vLLM의 로컬 모델도 호스팅 모델과 동일한 플래그로 작동하며, 다른 모든 클라이언트가 사용하는 동일한 MCP 서버를 통해 그래프에 도달합니다.```sh kin agent run --task "Find where the retry backoff is computed and document it"
--model qwen/qwen3.6-35b-a3b --base-url http://localhost:1234/v1

MCP 서버에 다른 에이전트를 연결하는 것과 다른 점은, 규칙이 벤더의 권한 계층에서 빌려오는 것이 아니라 에이전트 내부에서 강제된다는 것입니다. 여기에는 Kin의 도구와 정확히 두 개의 로컬 도구(`edit_file` 및 `write_file`)만 있습니다. 셸, grep, 파일 읽기 도구가 없으므로 원시 파일 검색으로 저장소 질문에 답할 수 없으며, 에이전트가 발명한 도구는 이름으로 거부됩니다. Kin이 빈 결과를 신뢰할 수 없다고 보고하면, 에이전트는 답을 알 수 없다고 안내받고, 해당 항목이 존재하지 않는다고 결론 내리는 대신 명명된 공백을 받습니다. 모든 편집은 Kin 세션 아래의 Kin 트랜잭션 내에서 실행되므로 변경 사항에는 에이전트를 명명하는 출처가 포함됩니다. 먼저 `kin agent doctor --base-url <url>`을 실행하여 양쪽 절반이 응답하는지 확인하세요. 전체 표면에 대해서는 [CLI 참조](https://github.com/firelock-ai/kin/blob/main/docs/cli-reference.md#kin-agent)를 참조하세요.

Claude Code, Codex, Cursor, Gemini 및 MCP를 지원하는 다른 모든 도구와의 작업은 일급으로 유지됩니다. `kin setup --intent agent`는 감지하는 모든 클라이언트를 한 번에 구성합니다. 다음은 Kin을 직접 설치하고 싶을 때 사용하는 클라이언트별 원라이너입니다.

클라이언트를 연결하기 전에 저장소에서 `kin init .`을 실행하세요. 그 후가 아니라요. 이러한 도구는 그래프에서 응답하므로, 그래프가 없는 디렉터리를 가리키는 클라이언트는 그 뒤에 아무것도 없는 도구 표면을 얻게 됩니다. `kin setup`은 그 자체로 이를 말합니다. 왕복 검사는 실행된 디렉터리 "위 또는 그 위치에 초기화된 Kin 저장소가 없음"을 보고하고, 해당 위치에서 `kin init`을 실행한 후 setup을 다시 실행하라고 안내합니다.

Claude Code, 세션 내부에서:```
/plugin marketplace add firelock-ai/kin
/plugin install kin@kin

Codex:```sh codex plugin marketplace add firelock-ai/kin codex plugin add kin@kin

Gemini CLI:```sh
gemini extensions install https://github.com/firelock-ai/kin

커서는 원클릭 설치 링크를 사용합니다. 이 링크를 커서에 붙여넣거나 브라우저의 주소 표시줄에 붙여넣으세요:``` cursor://anysphere.cursor-deeplink/mcp/install?name=kin&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBraW5sYWIva2luIiwibWNwIiwic3RhcnQiXX0=

Kiro는 웹 링크와 동일한 형식을 사용합니다:
[Add Kin to Kiro](https://kiro.dev/launch/mcp/add?name=kin&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40kinlab%2Fkin%22%2C%22mcp%22%2C%22start%22%5D%7D).

Cline은 한 줄 형식 대신 아래의 표준 항목을 사용합니다. 해당 CLI는
`~/.cline/mcp.json`을 읽습니다. VS Code 확장 프로그램에서는 MCP Servers 패널을 연 다음
Configure 탭, Configure MCP Servers를 차례로 열고 해당 항목을 추가하세요.

표준 MCP 구성을 읽는 다른 모든 클라이언트는 다음 항목을 사용합니다:```json
{
  "mcpServers": {
    "kin": { "command": "npx", "args": ["-y", "@kinlab/kin", "mcp", "start"] }
  }
}

kin setup statuskin doctor는 이 정확한 형태를 인식하며, kin setup이 작성하는 절대 경로 형태와 함께 다른 모든 것을 MISCONFIGURED로 분류합니다. command를 단순한 kin으로 줄이지 마십시오. 에이전트 클라이언트가 셸 PATH를 안정적으로 상속하지 않기 때문입니다. @kinlab/kin-mcp는 이전 런처이며 이미 이를 지정한 구성에서 계속 작동합니다. 새 구성은 전체 CLI의 한 모드로 동일한 MCP 서버를 제공하는 @kinlab/kin을 가리켜야 합니다.

래퍼에는 Node 20 이상이 필요하며, 첫 실행 시 일치하는 Kin 릴리스를 다운로드하고 게시된 SHA-256을 검증한 후 사용자별로 바이너리를 캐시합니다. Codex CLI는 [mcp_servers.kin] 아래의 TOML과 동일한 것을 원합니다.

반복할 가치가 있는 주의 사항 하나: 이러한 도구는 그래프에서 답을 얻으므로, semantic_locate가 무엇이든 순위를 매기기 전에 저장소를 kin init .으로 승인하고 kin embed로 임베드해야 합니다. llms-install.md는 빈 머신에서 첫 검증된 도구 호출까지 에이전트가 무인으로 따라갈 수 있도록 작성된 전체 경로입니다.

AI가 작성한 변경 사항 검토

AI가 코드를 작성합니다. Kin이 무엇이 변경되었는지 증명합니다.

검토하려는 브랜치에서 kin init을 실행하여 관련 Git 기록이 그래프에 들어가도록 한 다음, 보고 전용 섀도우 게이트에 명시적 커밋 SHA를 전달하십시오.```sh kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"

결과는 `PASS`, `NEEDS ATTENTION`, 또는 `WOULD BLOCK`이며, 그래프에서 파생된 영향 Kin, 이를 수리하는 데 필요한 컨텍스트, 그리고 그 뒤에 있는 증거가 함께 제공됩니다. 저자는 선언된 것이지 검증된 것이 아닙니다. 이 명령은 병합을 차단하거나 그래프 상태를 변경하지 않습니다. 증거를 사람 또는 CI 정책에 전달하고 거기서 멈춥니다.

## Kin이 Git과 맺는 관계

오늘날의 Git과 나란히. 시간이 지남에 따라 저장소 권한은. 브라운필드 도입 중에 Git은 명시적인 가져오기/내보내기 상호운용성 경계로 남아 있으며, Kin 런타임 쿼리에 응답하거나 누락된 그래프 진실을 수리하지 않습니다.

- `kin init`은 도달 가능한 전체 Git 히스토리와 정확한 부모 엣지를 가져옵니다. Kin은 의도적으로 부분 히스토리 또는 스냅샷 전용 초기화 모드가 없습니다.
- 가져온 후, Kin의 그래프는 저장소 정체성, 트리 상태, 히스토리, refs 및 의미론적 관계를 소유합니다. 파일시스템 및 Git 뷰는 투영(projection)입니다.
- `kin git export --output ../repo.git`은 그래프가 소유한 하나의 권한 세대에서 새 베어 Git 투영을 작성합니다. 작업 파일이나 주변의 `.git/` 객체 저장소를 참조하지 않으며, 기존 또는 저장소 내부 대상이 있으면 거부합니다. 객체, refs 및 디렉터리는 no-replace 대상 게시가 확인되기 전에 플러시됩니다. 기능 앵커 기반 게시는 현재 Unix 호스트에서 사용 가능하며, 다른 호스트는 내보내기를 생성하기 전에 거부합니다.

이를 통해 팀은 Kin이 권위가 되는 동안 편집기, 컴파일러, 빌드 시스템 또는 Git 상호운용성을 포기하지 않고 기존 저장소를 마이그레이션할 수 있습니다.

## 플랫폼 및 성숙도

코어 런타임과 파일시스템 투영은 서로 다른 지원 경계를 가집니다:

| 플랫폼 | 코어 Kin 런타임 | `kin-vfs` 투영 |
| --- | --- | --- |
| macOS, Apple Silicon 및 Intel | 네이티브 그래프, 벡터, 데몬, 셋업, MCP 및 리뷰 표면이 릴리스 아카이브에 포함됩니다. | 두 아키텍처 모두에서 제공되고 테스트됩니다. `DYLD_INSERT_LIBRARIES`를 사용하며, SIP 보호 또는 하드닝된 프로그램은 주입을 거부할 수 있습니다. |
| Linux x86_64 및 arm64 | `kin` 및 `kin-daemon`은 glibc 및 musl 배포판에서 실행되도록 설계된 정적 musl 빌드입니다. | 공개 VFS 실행 파일과 shim은 musl 빌드가 아닌 GNU/glibc 빌드입니다. 고정된 glibc 하한 2.31을 기준으로 빌드되고 OpenSSL 3에 링크되므로 투영 호스트에는 둘 다 필요합니다. Debian 12는 이를 로드하며, Alpine 및 기타 musl 배포판은 지원되는 투영 호스트가 아닙니다. 릴리스는 바이너리가 해당 하한보다 더 많은 glibc를 요구하는 Linux 아카이브 게시를 거부합니다. arm64 릴리스 증명은 Ubuntu 24.04에서 실행됩니다. |
| 네이티브 Windows x86_64 | 초기 지원: 저장소가 허용되고 그래프 및 어휘 쿼리가 네이티브로 응답하지만, MCP 및 리뷰 워크플로는 아직 설치 증명으로 종단 간 다루어지지 않습니다. 전체 Kin에는 WSL2가 권장 경로로 남아 있습니다. | 제공되지 않습니다. 투영을 위해 glibc 경계를 충족하는 Linux 배포판과 함께 WSL2를 사용하십시오. |

위의 모든 경우에서 그래프가 권위입니다. shim, NFS 마운트, FUSE 마운트 및 Windows ProjFS는 그 진실을 파일로 보는 네 가지 방법이며, Kin은 이 호스트가 실행할 수 있는 것을 탐색하여 그 사이를 선택합니다: 마운트가 가능한 곳에서는 마운트를 사용하는데, 커널이 이를 제공하고 어떤 프로세스도 이를 제거할 수 없기 때문이며, macOS 및 Linux에서는 주입된 shim이 호환성 폴백이고, shim이 없는 Windows에서는 ProjFS가 우선합니다. `kin vfs on`은 선택된 것을 활성화하고, `kin vfs off`는 비활성화하며, `kin doctor`는 어떤 것이 적용 중이고 작동하는지 알려주는 행을 포함합니다. 모드가 누락된 경우, Kin은 플랫폼에 대해 이를 설치하거나 활성화하는 정확한 줄을 출력합니다.
[docs/projection.md](https://github.com/firelock-ai/kin/blob/main/docs/projection.md)에는 전체 플랫폼별 표가 있습니다.

첫 번째 인덱싱은 도달 가능한 전체 Git 히스토리를 읽으므로, 크거나 오래된 저장소의 `kin init`은 임베딩이 시작되기 전에 몇 초가 아닌 몇 분이 걸립니다. `init`이 반환된 후에도 데몬은 백그라운드에서 준비를 계속하며, 대규모 저장소에 대한 첫 번째 에이전트 호출은 눈에 띄게 더 오래 걸릴 수 있습니다.

제한된 arm64 테스트에서 코어 그래프 및 어휘 경로가 512MB에서 사용 가능함을 확인했지만, 전체 임베딩은 약 522MB 모델을 다운로드하며 현재 안전한 운영 하한으로 2GB가 필요합니다. 1GB는 안전하지 않은 경계이고 512MB는 임베딩 중에 종료될 수 있습니다. 이는 관찰된 알파 제약이며, 보편적인 크기 약속이 아닙니다.

성공적인 `kin --version`은 코어 바이너리가 실행된다는 것만 확인합니다. VFS 호환성이나 활성 그래프 기반 투영을 확인하지는 않습니다. 지원되는 Unix 호스트에서는 각 투영 모드를 탐색하고 실제로 적용 중인 것을 출력하는 `kin vfs status`를 사용한 다음, `kin setup status`와 실제 `kin-vfs exec --workspace . -- <command>` 실행을 사용하십시오. VFS 런처는 삽입 카나리(interposition canary)를 포함하며 운영 체제가 shim을 제거할 때 보고합니다.
[kin-vfs README](https://github.com/firelock-ai/kin-vfs#current-platform-and-package-boundaries)에는 전체 경계가 포함되어 있습니다.

릴리스 자산은 체크섬으로 게시되며 릴리스 워크플로는 지원되는 러너 매트릭스 전반에 걸쳐 익명 설치, 데몬/MCP, 임베딩 및 실제 그래프 기반 VFS 투영 검사를 실행합니다. 워크플로 자체는 공개입니다:
[Install Proof](https://github.com/firelock-ai/kin/actions/workflows/install-proof.yml). 녹색 릴리스는 해당 정확한 아티팩트와 환경을 확립하며, 모든 배포판, 도구 또는 저장소 형태가 이미 다루어진다는 주장은 아닙니다.

## FAQ

### Kin이 Git을 대체하나요?

오늘날의 Git과 나란히. 시간이 지남에 따라 저장소 권한은. Git은 브라운필드 도입 중 명시적인 가져오기/내보내기 상호운용성 경계로 유지되므로, 팀은 편집기, 컴파일러, 빌드 시스템 또는 Git 상호운용성을 포기하지 않고 기존 저장소를 마이그레이션할 수 있습니다.

### 내 코드가 내 머신을 떠나나요?

Kin은 로컬 저장소 작업을 사용자 환경에 유지하므로, 저장소 수집, 그래프 저장 및 로컬 쿼리가 모두 그곳에서 실행됩니다. KinLab은 명시적 액세스 및 얼리 액세스 계약 하에 호스팅 협업을 추가하는 별도 제품입니다.

### 어떤 에이전트와 작동하나요?

Claude Code, Codex, Cursor, Gemini 및 MCP를 말하는 다른 모든 것과의 작업은 일급으로 유지됩니다. `kin setup --intent agent`는 감지된 모든 클라이언트를 한 번에 구성합니다.

### 병합을 차단하나요?

리뷰는 조언적이므로 차단 없이 위험을 표시하며 병합 결정은 팀에 남습니다. `kin review shadow`는 증거를 사람 또는 CI 정책에 전달하고 거기서 멈춥니다.

## 증명 자세

게시된 사전등록 Multi-SWE-Bench Go 증명 패키지는 이동 중인 최신 릴리스가 아닌 이전 빌드에 고정되어 있으며, 광범위한 속도, 토큰 절약 또는 카테고리 우승 주장을 확립하지 않습니다. 비교 결과는 독립적 검증이 있을 때까지 여기서 보류됩니다.

방법론, 작업 세트, 빌드 정체성 및 아티팩트는
[공개 증명 패키지](https://firelock.ai/labs/kin-proof)에서 읽으십시오. 측정된 범위 밖의 주장은 자체 재현 가능한 증명이 있을 때까지 가설로 취급하십시오.

## 글쓰기

Kin을 구축하면서 얻은 엔지니어링 노트는 낯선 사람이 재사용할 수 있도록 기록되었으며, [kinlab.ai/blog](https://kinlab.ai/blog)에 있으며 피드는 [kinlab.ai/rss.xml](https://kinlab.ai/rss.xml)에 있습니다.

- [아무것도 측정하지 않아 통과한 검사](https://kinlab.ai/blog/checks-that-cannot-fail)
- [코드 검색에서 아무도 사용하지 않는다고 합니다. 삭제해도 되나요?](https://kinlab.ai/blog/empty-answer-safe-to-delete)

## 배우고 기여하기

- [빠른 시작 및 고급 구성](https://github.com/firelock-ai/kin/blob/main/docs/quickstart.md)
- [저장소 크기와 그 원인](https://github.com/firelock-ai/kin/blob/main/docs/store-size.md)
- [MCP 도구 참조](https://github.com/firelock-ai/kin/blob/main/docs/mcp-tools.md)
- [언어 지원 및 각 계층이 추출하는 내용](https://github.com/firelock-ai/kin/blob/main/docs/language-support.md)
- [환경 변수 참조](https://github.com/firelock-ai/kin/blob/main/docs/env-vars.md)
- [그래프 우선 논제](https://github.com/firelock-ai/kin/blob/main/docs/thesis.md)
- [쓰기 권한 모델 및 전환 상태](https://github.com/firelock-ai/kin/blob/main/docs/write-authority-model.md)
- [GitHub Discussions](https://github.com/firelock-ai/kin/discussions)
- [버그 보고 및 기능 요청](https://github.com/firelock-ai/kin/issues/new/choose)
- [기여 가이드](https://github.com/firelock-ai/kin/blob/main/CONTRIBUTING.md)
- [비공개 보안 보고](https://github.com/firelock-ai/kin/blob/main/SECURITY.md)

## 라이선스

[Apache-2.0](https://github.com/firelock-ai/kin/blob/main/LICENSE).

<p align="center"><em>자신을 기억하는 소프트웨어.</em></p>

카테고리