Kin 是一个面向 AI 智能体及其构建者的图原生代码仓库。 它将源代码、记录的代码关系以及带版本的历史作为仓库状态存储。图就是仓库模型，而不是在另一个仓库旁边维护的搜索索引。
函数、类型以及它们之间的关系都是你可以提交、分支和合并的数据。精确的源代码按字节逐一保留，文件系统投影让受支持的工具可以继续使用普通文件。
公开测试版。 在你熟悉的真实项目上试用 Kin。请预期会有粗糙之处。
点一个 star 能帮助其他人发现 Kin，而 Discussions 是提出相关问题的好去处。
在修改一个共享函数之前，你还应该检查什么？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 crate 是一个无关的项目。
从一个你熟悉的项目的全新完整克隆开始。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
无论采用哪种方式，都要以单独的命令重新加载你的 shell，因为安装过程会将 kin 放入 ~/.kin/bin，并将该目录添加到你的 shell 配置文件中，以便新会话生效：
exec "$SHELL" -l
在原生 Windows x64 上，使用 PowerShell 通过 irm https://get.kinlab.dev/install.ps1 | iex 进行安装。
它会安装 kin CLI，但不会连接 AI 编码工具，因为在 Windows 上 WSL2 仍是
推荐路径。Beta 限制 下的 Windows 条目
说明了在那里可用的功能。未发布原生 Windows ARM64 构建。在 ARM64 机器上，请从 x64 PowerShell
运行该命令，以在模拟环境下安装 x86_64 构建，或使用 WSL2。
安装程序会将 kin 添加到你的用户 PATH，因此在下一步之前，请打开一个新的 PowerShell 窗口，以替代
exec "$SHELL" -l。
有关其他安装程序或故障排除，请参阅完整快速入门。
在新的提示符下，使用 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 和守护进程安装，包括它们确切的源标识。普通命令会拒绝不匹配的配对；开发构建使用隔离状态。参见 运行时安装。
图和词法检索无需模型即可工作。嵌入和重排序是可选的，其模型提供方默认为 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 还包含 kin agent run，用于本地或托管的 OpenAI 兼容模型端点。
本地导入、存储和图查询都在你的机器上运行。安装 Kin 需要网络访问；默认的图检索路径不需要下载模型。当选择了嵌入提供方时，查询会报告其向量覆盖率和任何缺口。
在你想审查的 Git 分支上运行 kin init 后，将显式提交 SHA 与 main 进行比较：
kin review shadow "$(git rev-parse main)..$(git rev-parse HEAD)"
报告会返回 PASS、NEEDS ATTENTION 或 WOULD BLOCK，并附带由图推导出的影响和支撑证据。它仅作参考： 它不会阻止合并，也不会改变图状态。作者身份是声明的，而非独立验证的。
Kin 拥有自己的提交、分支、合并、差异和历史记录，包括在底层没有 Git 的仓库中也是如此。现有的 Git 仓库可以被导入，受支持的工作流可以导出一个新的 Git 仓库。
覆盖范围不完整。 受支持的语言会被解析为实体和关系；其他文件仍可作为内容和历史记录使用。空结果并不能证明不存在调用方或依赖项。请继续使用你的编译器、测试和审查。参见语言支持。
兼容性因平台而异。 发布归档不包含已弃用的 kin-vfs 文件系统投影，因此没有可依赖的透明投影。请查看平台说明了解各平台支持的内容。
备份仅存于 Kin 的状态。 你用 Kin 记录的提交、分支、审查和规格存放在仓库的 Kin 存储中，而非 Git 中。删除存储并从 Git 重新导入无法恢复它们，因此请先运行 kin backup create。出于同样的原因，kin store prune 仅在你传入 --yes 时才会删除存储。请阅读导入、恢复和升级说明。
Windows。 原生 Windows x86_64 支持尚处于早期阶段。仓库准入功能可用：kin init 可导入 Git 仓库并发布图权威，图查询、词法查询和守护进程支持的查询均可在原生环境下应答。端到端安装验证还会在原生 Windows 上运行 agent 设置，并从已安装的 MCP 服务器获得由图支持的答案。透明文件系统投影尚未在 Windows 上发布，审查工作流也尚未在那里测试，因此 WSL2 仍是获得完整 Kin 体验的推荐路径。
我不断看到编码 agent 拼凑出我们已经处理过的代码库的各个部分。然后我自己会做类似的工作来审查它们的改动。我开始思考，为什么更多的这种结构性理解没有成为仓库本身的一部分。
这就是我正在用 Kin 构建的东西。
Troy
CLI 参考 · 架构与详细限制 · 贡献指南 · 问题反馈 · 安全
Kin 及其本地技术栈（包括 kin-db）采用 Apache-2.0 许可。KinLab 是独立的专有托管产品。公共仓库的接入功能仍在开发中。