kin v0.3.4

Kin、人とAIエージェントのためのコードリポジトリ

コードのための新しい基盤。

Kinは、人とAIエージェントのためのグラフネイティブなコードリポジトリです。 ソースコード、記録されたコードの関係性、バージョン管理された履歴をリポジトリの状態として保存します。グラフはリポジトリのモデルそのものであり、別のリポジトリの隣で維持される検索インデックスではありません。

関数、型、そしてそれらの間の関係性は、コミット、ブランチ、マージできるデータです。正確なソースはバイト単位で保持され、ファイルシステム投影によって対応ツールは通常のファイルを使い続けられます。

パブリックベータ。 よく知っている実際のプロジェクトでKinを試してみてください。粗削りな部分は想定内です。

クイックスタート · ドキュメント · ブラウザデモ

kin impact human_bytes --file crates/kin-cli/src/commands/cache.rs --kind function --depth 1 の実行結果。Kin自身のコードベースにおける直接の呼び出し元を、同じ名前に対する git grep 検索と並べて表示

スターは他の人がKinを見つける助けになります。質問はDiscussionsへどうぞ。

つながりを見る

共有関数を変更する前に、他に何を確認すべきでしょうか？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クレートは無関係なプロジェクトです。

クイックスタート

よく知っているプロジェクトの新規の完全なクローンで始めてください。kin initはGit履歴を変更せず、追跡ファイルにも手を加えずに読み取ります。.kinディレクトリと.git/info/excludeへの1行を追加します。インポートはブランチとタグが到達するすべてのコミットを対象とするため、時間、メモリ、ディスクはチェックアウトのサイズではなく履歴に応じて増加します。開始前に、kin initはメモリと空きディスクを確認し、マシンの容量不足がすでに判明している場合は数値を示して停止します。シャロークローン、サブモジュール、Git LFSはサポートされていません。また、Gitフック、スパースチェックアウト、未完了のマージやリベースもインポートを停止させます。kin initはそれぞれの対処法を示し、新規クローンならそのほとんどを回避できます。

1. インストール

macOS、Linux、WSL2では、1つのコマンドで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ウィンドウを開いてください。

他のインストーラーやトラブルシューティングについては、完全なクイックスタートを参照してください。

2. リポジトリを初期化する

新しいプロンプトで、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をそれに接続します。これらのクライアントはリポジトリを指定するエントリを1つ保持するためです。

Windows PowerShell 5.1には&&がないため、ネイティブWindowsでは同じコマンドを1つずつ実行し、失敗したら停止してください:

cd C:\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. AIコーディングツールとセマンティック検索

kin setupは、検出したAIコーディングツールを接続する前にすでに確認し、同意した場合は接続済みです。別途リンクの手順はありません。別のツールをインストールした後は、再度kin setupを実行してください。kin setup statusは何が接続されているかを表示します。Windowsでは、WSL2内でAIツールを接続してください。

セマンティック検索は約523 MBのローカルモデルで動作し、セットアップは何かがダウンロードされる前に確認します。拒否した場合、またはkin initが検索インデックスがモデルを待っていると表示した場合は、以下でモデルをダウンロードしてインデックスを構築します:

kin embed

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を、グラフから導出された影響と裏付けとなる証拠とともに返します。これは助言的なものです: マージをブロックしたり、グラフの状態を変更したりしません。 authorshipは宣言されたものであり、独立して検証されたものではありません。

Gitの有無にかかわらずKinを使う

Kinには独自のコミット、ブランチ、マージ、差分、履歴があり、下にGitがないリポジトリでも利用できます。既存のGitリポジトリはインポートでき、サポートされているワークフローでは新しいGitリポジトリをエクスポートできます。

ネイティブバージョン管理のウォークスルー · Git相互運用とエクスポートの制限

ベータ版の制限

カバレッジは不完全です。 サポートされている言語はエンティティと関係性に解析されますが、その他のファイルはコンテンツと履歴として利用可能なままです。空の結果は、呼び出し元や依存関係が存在しないことを証明するものではありません。コンパイラ、テスト、レビューを引き続き使用してください。言語サポートを参照してください。

互換性はさまざまです。 リリースアーカイブには非推奨のkin-vfsファイルシステム投影が含まれていないため、依存できる透過的な投影はありません。各プラットフォームが何をサポートするかはプラットフォームノートを確認してください。

Kin専用の状態をバックアップしてください。 Kinで記録したコミット、ブランチ、レビュー、スペックはGitではなく.kinに存在します。.kinを削除してGitから再インポートしてもそれらは復元されないため、まずkin backup createを実行してください。インポート、リカバリ、アップグレードの注意事項をお読みください。

Windows。 ネイティブWindows x86_64のサポートは初期段階です。リポジトリの取り込みは動作します: kin initはGitリポジトリをインポートしてグラフの権威を公開し、グラフ、字句、デーモンベースのクエリがネイティブに応答します。エンドツーエンドのインストール検証では、ネイティブWindows上でエージェントセットアップも実行し、インストールされたMCPサーバーからグラフに基づく回答を得ています。透過的なファイルシステム投影はWindowsでは提供されておらず、レビューワークフローもまだそこでテストされていないため、Kinの完全な体験にはWSL2が引き続き推奨される方法です。

なぜKinを作ったのか

コーディングエージェントが、すでに取り組んだことのあるコードベースの部分をつなぎ合わせているのを何度も見てきました。そして、その変更をレビューするために、私自身も同じような作業をしていました。なぜその構造的な理解の多くがリポジトリ自体の一部ではないのか、と考えるようになりました。

それが、私がKinで作っているものです。

Troy