kin v0.6.4

AIはコードを書く人を変えた。
Kinはその人たちが何の上に構築するかを変える。

Kinは、人とAIエージェントのためのオープンソースのコードリポジトリ兼バージョン管理システムです。 コードがどのように組み合わさっているかを追跡し続けるので、ある変更が何に影響を与えるかを調査できます。

関数、型、記録された関係、変更履歴は、コミット、ブランチ、マージの対象となるリポジトリのデータです。グラフはリポジトリのモデルであり、Gitの横に並ぶ別個のインデックスではありません。正確なソースはバイト単位で保持され、ファイルシステムへの投影により、対応ツールは通常のファイルを扱い続けられます。

スターは他の人がKinを見つける助けになり、DiscussionsはKinについての質問を持ち寄る場所です。

パブリックアルファ。 よく知っている小さなリポジトリから始めてください。粗削りな部分や破壊的変更を想定してください。

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

つながりを見る

共有された関数を変更する前に、他に何を調べるべきでしょうか？Kinでは、記録された呼び出し元を検索し、関連するコードを探索できます。CLIとMCPサーバーは同じグラフに問い合わせるので、あなたとあなたのエージェントは同じ記録に基づいて作業できます。

e89fff89ac9af12e8d4ce9d5fd07beb408ca730f で準備されたripgrepグラフ上で記録。生の実行成果物は公開されていません。これはワークフローの例示であり、パフォーマンスのベンチマークではありません。

Claude Code、Codex、Cursorから使う

Claude Codeの場合：

/plugin marketplace add firelock-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 クレートは無関係なプロジェクトです。

クイックスタート

小さなGitリポジトリの使い捨てコピーを使用してください。インポートには到達可能な完全な履歴が含まれ、かなりの時間とメモリを要する場合があります。シャロークローン、サブモジュール、Git LFSはサポートされていません。

1. インストール

macOSまたはLinuxでは、インストーラーを実行し、セットアップのプロンプトを完了してください：

curl -fsSL https://get.kinlab.dev/install | sh

完了後、別のコマンドとしてシェルを再読み込みしてください：

exec "$SHELL" -l

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

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

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

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

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

アルファ版の制限

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

互換性はさまざまです。 ファイルシステム投影には、プラットフォームとツールごとの個別の制限があります。それに依存する前にプラットフォームに関する注意事項を確認してください。

Kin固有の状態を保持してください。 .kin を削除してGitから再インポートしても、Kinにのみ存在したコミット、レビュー、その他の状態は復元されません。インポート、リカバリ、アップグレードに関する注意事項をお読みください。

Windows。 ネイティブWindows x86_64のサポートは初期段階です。リポジトリの受け入れは機能します：kin init はGitリポジトリをインポートしてグラフの権威を公開し、グラフ、字句、デーモンベースのクエリはネイティブに応答します。透過的なファイルシステム投影はWindowsでは提供されておらず、エンドツーエンドのインストール証明はまだMCPやレビューのワークフローをカバーしていないため、Kinの完全な体験にはWSL2が依然として推奨される経路です。

Kinを作った理由

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

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

Troy

さらに学び、貢献する

CLIリファレンス · アーキテクチャと詳細な制限 · コントリビューション · Issues · セキュリティ

Kinとそのローカルスタック（kin-dbを含む）はApache-2.0です。KinLabは別個のプロプライエタリなホスト型製品です。公開リポジトリのオンボーディングはまだ開発中です。