kin v0.3.3

AIエージェントは、チームが変更が何に影響するか、以前の修正を元に戻すかどうか、その影響がどこまで及ぶかを把握するよりも速く変更を書くことができます。Gitはファイルと行の履歴を記録します。Kinはソフトウェア自体をエンティティ、リレーション、変更、および来歴のグラフとして記録し、人間とエージェントにクエリとレビューのための単一の意味論的権威を提供します。変更が触れるものはマージ前に表示され、エージェントはリポジトリを再読む代わりに正確なコンテキストから作業します。

KinはAIが書いたソフトウェアのための意味論的なシステム・オブ・レコードです。これは初期アルファ版であり、現在はローカルCLI、デーモン、MCPサーバー、レビューサーフェス、およびグラフ対応ファイルシステムプロジェクションとして利用できます。プレ1.0版のため、粗い部分や破壊的な変更があることを想定してください。重要なワークフローに採用する前に、最新の安定版リリースと現在の制限事項を確認してください。

実際のリポジトリで確認する

ripgrepでの1行のシグネチャ変更は、差分では無害に見えます。コンパイラが実行される前にkin impactに問い合わせると、その編集が到達するものを特定します。変更されたシグネチャの呼び出し元が最初に来て、次にそれらの呼び出し元が背後で引き込むすべてのものが続きます。

ripgrepコミットe89fff89ac9af12e8d4ce9d5fd07beb408ca730fで準備されたグラフに対して記録されています。1行のシグネチャ編集で、Kinはコンパイラが実行される前に影響を受けるエンティティを表示します。グラフは事前に構築されました。コンパイラは実行されていません。正確なコマンドはkinlab.ai/proofにあります。生の実行ディレクトリはまだ公開されていないため、これは監査できるトレースではなく、再実行できるレシピです。

Kinは変更が触れるものを表示します。変更が正しいかどうかは、コンパイラ、テスト、およびレビューに委ねられます。グラフはkin initによって事前に構築され、その構築がコストのかかる部分です。その後、影響の質問はツリーを再読むのではなく、グラフの真実から回答されます。

スタック

Kinは、いくつかの明確な公開サーフェスを持つ単一のシステムです:

各部分の連携

KinはAIが書いたソフトウェアのための意味論的なシステム・オブ・レコードであり、以下のマップ内のすべてはその権威に到達するか、それをサポートします。人間とAIエージェントはCLI、バンドルされたMCPサーバー、またはVS Code拡張機能を通じて入ってきます。3つすべてが同じデーモンに問い合わせ、デーモンはツリーを再読むのではなくグラフの権威から回答します。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)** | セマンティックレイヤーに供給する言語サーバーによる拡張。 |

これらは1つのシステムの実装レイヤーであり、新しいユーザーが組み立てる必要のある
別々の製品ではありません。どれも個別にインストールされるものではありません。

## オープンソースと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)
は公開されているため、主張はそれを生成したシステムにアクセスしなくても検証できます。
封印された証拠バンドルを生成するランナーと証明インフラストラクチャ（
オーケストレーション、固定リリースの証明ゲート、ホスト型測定
環境）は、当面は非公開のままです。仕様と検証ツールが先に公開され、ランナーは
後で公開できます。

## 最短のグラフバックパス

### 1. Kinのインストールと設定

macOSまたはLinuxの場合:```sh
curl -fsSL https://get.kinlab.dev/install | sh
exec "$SHELL" -l
kin setup --intent agent

インストーラーは最新の安定版リリースを解決し、 公開されている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は意図的に、現在のユーザーのみが 使用する非アクティブな兄弟権限サイドカーを1つ保持します。このロックIDを安定に保つことで、クラッシュや 同時実行中の将来のインストールが2つの独立した変更権限を作成するのを防ぎます。CLIとJSON結果は、 ゼロ残存バイトを主張するのではなく、この保持された調整メタデータを開示します。

手動インストールの場合、各アーカイブとその.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 ではなく、バイナリへの絶対パスを指定してください。登録形式については エージェントとの連携 を参照してください。

Homebrew タップは同じリリースチャンネルを追跡します:```sh brew install firelock-ai/kin/kin

The tap's formula is generated rather than hand-maintained. Its version and its
per-platform SHA-256 are regenerated from each Kin release by
`update-formula.yml` in the tap repository, on a dispatch the release itself
sends, with a six-hourly reconcile that self-heals a missed one. That is why the
checksum Homebrew verifies is the one published beside the archive rather than a
separately curated copy of it. Confirm what you installed with `kin --version`,
as you should on any install path.

On Windows, run `irm https://get.kinlab.dev/install.ps1 | iex` in PowerShell.
Native Windows x86_64 support is early. Repository admission works: `kin init` imports a Git repository and publishes graph authority, and graph, lexical, and daemon-backed queries answer natively. Transparent filesystem projection is not shipped on Windows, and the end-to-end install proof does not yet cover MCP or review workflows there, so WSL2 remains the recommended path for the full Kin experience.
Read [Platform and maturity](#platform-and-maturity) below before choosing a
Windows install path.

### 2. Admit an existing repository as graph truth```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の言語アダプタのいずれかが主張するファイルを意味します。アダプタレジストリが全体の集合であり、リポジトリ内のすべてのファイルはそれを介して解決されます：

.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

`ExactEntityName` を、`locate` が返すシンボルに置き換えます。`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の2つだけです。シェルもgrepもファイル読み取りツールもないため、生のファイル検索からリポジトリの質問に答えることはできず、エージェントが発明したツールは名前で拒否されます。Kinが空の結果は信頼できないと報告した場合、エージェントは答えが不明であると伝えられ、存在しないと結論付ける代わりに名前付きのギャップが与えられます。すべての編集はKinセッション内のKinトランザクション内で実行されるため、変更にはエージェントを特定する来歴が付与されます。まずkin agent doctor --base-url <url>を実行して、両方の半分が応答することを確認してください。完全なサーフェスについてはCLIリファレンスを参照してください。

Claude Code、Codex、Cursor、Gemini、その他MCPを話すものとの連携は、引き続きファーストクラスです。kin setup --intent agentは、検出したすべてのクライアントを一度に設定します。Kinを直接インストールしたい場合は、以下がクライアントごとのワンライナーです。

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 はワンクリックインストールリンクを受け付けます。これを Cursor またはブラウザのアドレスバーに貼り付けてください:```
cursor://anysphere.cursor-deeplink/mcp/install?name=kin&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBraW5sYWIva2luLW1jcCJdfQ==

Kiroはウェブリンクと同じものを取ります： KinをKiroに追加。

Clineはワンライナーではなく、以下の標準エントリを取ります。そのCLIは ~/.cline/mcp.jsonを読み取ります。VS Code拡張機能では、MCP Serversパネルを開き、 Configureタブ、Configure MCP Serversの順に進み、そこにエントリを追加します。

標準のMCP設定を読み取る他のすべてのクライアントは、このエントリを取ります：```json { "mcpServers": { "kin": { "command": "npx", "args": ["-y", "@kinlab/kin-mcp"] } } }

ラッパーにはNode 20以降が必要で、初回実行時に対応するKinリリースをダウンロードし、公開されたSHA-256を検証して、バイナリをユーザーごとにキャッシュします。Codex CLIは、`[mcp_servers.kin]`の下でTOMLとして同じものを求めます。

繰り返し述べる価値のある注意点が1つあります。これらのツールはグラフから回答するため、`semantic_locate`が何かをランク付けする前に、リポジトリを`kin init .`で受け入れ、`kin embed`で埋め込む必要があります。[llms-install.md](https://github.com/firelock-ai/kin/blob/main/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 のグラフがリポジトリのアイデンティティ、ツリー状態、履歴、参照、および意味的関係を所有します。ファイルシステムと Git のビューは投影です。
• kin git export --output ../repo.git は、グラフが所有する 1 つの権限世代から新しいベア Git 投影を書き出します。作業ファイルや周囲の .git/ オブジェクトストアを参照せず、既存の宛先やリポジトリ内の宛先を拒否します。オブジェクト、参照、ディレクトリは、置換なしの宛先公開が確認される前にフラッシュされます。機能に固定された公開は現在 Unix ホストで利用可能です。他のホストはエクスポートを作成する前に拒否します。

これにより、チームは既存のリポジトリを移行しながら、エディタ、コンパイラ、ビルドシステム、Git の相互運用性を放棄することなく、Kin が権威を持つことができます。

プラットフォームと成熟度

コアランタイムとファイルシステム投影では、サポート境界が異なります:

上記のすべてのケースで、グラフが権威です。シム、NFS マウント、FUSE マウント、Windows ProjFS は、その真実をファイルとして見る 4 つの方法であり、Kin はこのホストが実行できるものをプローブしてそれらを選択します: 利用可能な場所にマウントします。カーネルがそれを提供し、プロセスがそれを剥奪できないため、macOS と Linux では注入されたシムが互換性のフォールバックとして、Windows ではシムが存在しないため ProjFS が優先されます。kin vfs on は選択されたものを有効にし、kin vfs off はそれを無効にし、kin doctor はどれが有効で機能しているかを示す行を保持します。モードが欠落している場合、Kin はプラットフォームにそれをインストールまたは有効化する正確な行を出力します。 docs/projection.md に完全なプラットフォーム別テーブルがあります。

最初のインデックス作成は到達可能な Git 履歴全体を読み取るため、大規模または長期運用のリポジトリでの kin init は、埋め込みが始まる前に数秒ではなく数分かかります。init が戻った後も、デーモンはバックグラウンドで準備を続け、大規模リポジトリでの最初のエージェント呼び出しは、応答に著しく時間がかかる場合があります。

制限付き arm64 テストでは、コアグラフと語彙パスが 512 MB で使用可能であることがわかりましたが、完全な埋め込みでは約 522 MB のモデルがダウンロードされ、現在は安全な動作フロアとして 2 GB が必要です。1 GB は安全でないエッジであり、512 MB は埋め込み中に終了する可能性があります。これらは観察されたアルファ版の制約であり、普遍的なサイズ設定の約束ではありません。

kin --version が成功した場合、コアバイナリが実行されることだけが確立されます。VFS の互換性や、ライブのグラフバックアップ投影は確立されません。サポートされている Unix ホストでは、各投影モードをプローブし、実際に有効なものを出力する kin vfs status を使用し、次に kin setup status と実際の kin-vfs exec --workspace . -- <command> の起動を使用します。VFS ランチャーにはインターセプションカナリアが含まれており、オペレーティングシステムがシムを剥奪したときに報告します。 kin-vfs README に完全な境界が含まれています。

リリースアセットはチェックサム公開され、リリースワークフローは、サポートされているランナーマトリックス全体で、匿名インストール、デーモン/MCP、埋め込み、および実際のグラフバックアップ VFS 投影チェックを実行します。ワークフロー自体は公開されています: Install Proof。 グリーンリリースは、それらの正確なアーティファクトと環境を確立します。すべてのディストリビューション、ツール、またはリポジトリの形状がすでにカバーされているという主張ではありません。

FAQ

Kin は Git を置き換えますか?

今日の Git の隣にあります。時間の経過に伴うリポジトリの権限。Git はブラウンフィールド導入中の明示的なインポート/エクスポートの相互運用性の境界として残るため、チームはエディタ、コンパイラ、ビルドシステム、Git の相互運用性を放棄することなく既存のリポジトリを移行できます。

私のコードは私のマシンから出ますか?

Kin はローカルリポジトリの作業を環境内に保持するため、リポジトリの取り込み、グラフストレージ、ローカルクエリはすべてそこで実行されます。KinLab は、明示的なアクセスおよび早期アクセス契約の下でホスト型コラボレーションを追加する別の製品です。

どのエージェントと連携しますか?

Claude Code、Codex、Cursor、Gemini、および MCP を話すその他すべてのものとの連携は、ファーストクラスのままです。kin setup --intent agent は、検出したすべてのクライアントを 1 回で設定します。

マージをブロックしますか?

レビューは助言的であるため、ブロックせずにリスクをフラグし、マージの決定はチームに委ねられます。kin review shadow は証拠を人間または CI ポリシーに渡して、そこで停止します。

証明の姿勢

公開されている事前登録済みの Multi-SWE-Bench Go 証明パッケージは、最新のリリースではなく、古いビルドに固定されており、広範な速度、トークン節約、またはカテゴリ勝利の主張を確立するものではありません。比較結果は、独立した検証が行われるまでここでは保留されています。

方法論、タスクセット、ビルド ID、およびアーティファクトは、 公開証明パッケージ でお読みください。測定された範囲外の主張は、独自の再現可能な証明が得られるまで仮説として扱ってください。

執筆

Kin の構築からのエンジニアリングノートは、見知らぬ人が再利用できるように書き留められており、kinlab.ai/blog にあり、フィードは kinlab.ai/rss.xml にあります。

• 何も測定しなかったために合格したチェック
• あなたのコード検索は、それが何も使用していないと言っています。削除できますか?

学ぶことと貢献

• クイックスタートと高度な設定
• ストアサイズとその要因
• MCP ツールリファレンス
• 言語サポートと各ティアが抽出するもの
• 環境変数リファレンス
• グラフファーストの論文
• 書き込み権限モデルとその移行状態
• GitHub Discussions
• バグ報告と機能リクエスト
• 貢献ガイド
• プライベートセキュリティ報告

ライセンス

Apache-2.0。

自分自身を記憶するソフトウェア。