@cairnkeep/cli

中文文档
2.28.0发布于 2026/10/31Apache-2.0ES Module构建来源已验证近 30 天下载 1896

为编码代理和MCP客户端提供可持久,可支配的可知内存+上下文层.

中文使用文档
文档目录7 节
  1. 为什么是凯恩克普?
  2. 快开始
  3. 编码代理
  4. 信任边界
  5. 文档
  6. 捐助和支助
  7. 许可证

凯恩克普

CI npm license

持久,本地第一的内存和编码代理的上下文.

Cairnkeep 帮助编码代理在会话中传送项目背景 绳子。 它将决策、限制、模式和经验教训储存在 然后给代理商一个查找和 在不将记忆变成权威或权威的情况下,验证上下文 自动代理运行时间 .

为什么是凯恩克普?

  • 各届会议的连续性. 回顾项目决定和经常性 失败而不是从头开始重新发现它们.
  • 驾驭独立. 通过 Claude Code, OpenCode, 使用同样的内存 , Codex CLI,Kimi代码,Quen代码,Pi,或另一个MCP客户端.
  • 默认为本地 . 默认 stdio 服务器存储您计算机上的数据; 远程访问、嵌入、捕捉和外部环境是明确的 选入.
  • 受约束的特工指导. 管理 AGENTS.md 指令和项目 游戏本告诉兼容的代理何时检索上下文以及检查哪个 申请,但绝不执行工作或批准.
  • 权力最小. 完成 MCP 说明,只读/客户工具配置, 和不可改变的上下文包保持观察与 行动.

快开始

凯恩克普需要22号节点或更新. 在一个交互式终端, 引导 设置显示可选择的 Git 和内存选择以及每个选项的复选框 已支持的编码工具 :

npm install --global @cairnkeep/cli
cairn setup /path/to/project
cd /path/to/project
cairn doctor
./.ai/start-codex.sh                 # Windows: .\.ai\start-codex.cmd

在此路由的带状检查表中选择 Codex CLI 。 审查 .codex/config.toml 并接受 Codex 项目信任的第一使用提示. 自动化可以明确提供每个选项;快速启动文档: 决取之形.

见 快速启动 克劳德代码,第一个 记忆/召回周期、恢复和设置所有权。 见 牵引兼容性 准确的表面 由每个客户端支持.

核心循环是故意小的:存储一个简洁的,经过核实的项目事实, 关闭会话,并在后期任务需要时检索。 克劳德代码和 打开代码曝光 /remember 财务报告和审定财务报表 /recall; 任何兼容的 MCP 客户端都可以使用 memory_write 财务报告和审定财务报表 memory_search 直接说.

编码代理

设置一个管理下的项目指令块, 并设置一个小的 协议 :

  1. 对于可能取决于先前项目知识的非三角任务,请制作 任务产生的项目范围 memory_search 第一个工具或命令.
  2. 将结果视为定位器,而不是真理;验证所维护的存储器 他们提到的消息来源.
  3. 如果内存不存在或有,继续正常的仓库检查 没有相关结果.
  4. 除非用户或一个用户 经审查的工作流程明确要求这样做.

Cairnkiep游戏本可以建议或要求现有的审查、核实、, 安全、文件和学习步骤。 他们不运行这些步骤, 激活技能,启用能力,或授权破坏性工作.

读取 编码代理的 Cairnkeep 全部合同, 权威模式,控制行为, 优雅的回落.

信任边界

凯恩克普不是主机 遥测服务或自动遥控器 知识收集者。 记忆是耐久的背景,不是真相的来源 文档。 已配置 Claude 代码和 OpenCode 钩子可以从本地获取 记忆候选人; 持久晋升和每个联网或敏感抓取 路径继续单独控制。 一般的未安装保留耐用数据 除非要求明确清洗.

开始 隐私和数据流动, (中文(简体) ), 内存存储和部署,以及 安全保证和威胁模式 在此之前 允许远程 HTTP、嵌入、轨迹、文物、工作证据或 上下文包.

文档

这个 文件枢纽 是设置的索引,代理, 行动、可选特征、部署、学习路径和贡献者 向导。 特别是:

该寄存器支持了Linux,macOS,原生Windows x64,WSL,Node.js 22/24/26, 和真实的Bash 3.2在兼容性指南所记录的边界内.

捐助和支助

见 捐款额 促进发展和拉动要求 准则, 支助 帮助,和 警卫 页:1 私人脆弱性报告.

许可证

Apache-2.0 2026 斯特凡诺·通多

版本与发布记录

@cairnkeep/cli 共发布 58 个版本,首次发布于 2026/07/14;过去 12 个月发布了 58 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.28.0latest2026/10/319 天前
2.28.0-rc.1next2026/10/3110 天前
2.27.02026/10/2614 天前
2.26.02026/10/2614 天前
2.25.02026/10/2515 天前
2.24.02026/10/2516 天前

关于 @cairnkeep/cli 的常见问题

@cairnkeep/cli 是什么?

为编码代理和MCP客户端提供可持久,可支配的可知内存+上下文层.

如何安装 @cairnkeep/cli?

在项目目录运行 npm install @cairnkeep/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cairn、cairn-container,可以用 npx cairn 直接运行。

@cairnkeep/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cairnkeep__cli 是否存在。

@cairnkeep/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cairnkeep/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cairnkeep/cli 可以商用吗?

@cairnkeep/cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cairnkeep/cli 的下载量有多少?

根据 npm 官方下载统计,@cairnkeep/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 1,896 次,日均约 63 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cairnkeep/cli 还在维护吗?

最新版本 2.28.0 发布于 2026/10/31(9 天前);至今共发布 58 个版本,其中过去 12 个月发布了 58 个;首次发布于 2026/07/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。