EN中文
Kedu GitHub · jasonshrepo/kedu

Kedu 是 AI 编程 agent 的记录层

Kedu 在 GitHub 以源码优先方式发布,把可审计的开发会话记录保存为你自己拥有的纯文本文件。Claude Code、Codex、Kiro、Cursor,或下一个工具,都能从同一份证据继续。

~/project — agent session
# 一次真实会话结束时,你告诉 agent 什么值得保存 /kedu-log 我们决定了什么、接下来该做什么 record a17f3c:4 → .kedu/short.jsonl updated .kedu/STATE.md # 第二天,另一个 agent,同一个仓库 /kedu-search auth decision a17f3c:4 选择 JWT 的原因与证据 d80b91:2 被否定的方案与原因

官方 GitHub 仓库

jasonshrepo/kedu 安装 Kedu。

Kedu 当前是源码优先开发者预览版。仓库包含 CLI、agent skills、安装脚本、测试和文档,用于本地优先的 AI 编程会话记录。

仓库:github.com/jasonshrepo/kedu 许可证:Apache-2.0 · 运行时:Python 3.11+ · 平台:macOS 和 Linux 核心思想:记录发生了什么、谁做的、证据在哪里、下一步该做什么。
# clone Kedu GitHub 仓库 $ git clone https://github.com/jasonshrepo/kedu.git $ cd kedu && bash install.sh # 接入一个真实项目 $ cd /path/to/your/project $ kedu init --host claude 本地记录层已就绪

问题

来之不易的上下文会随线程消失。

你给 agent 讲清架构、决策、坑和未完成事项。会话一结束,这些理解就蒸发了。下一次,又要从头解释。

01

随线程消亡

关闭对话或撞上上下文上限,共享理解就没了。

02

无法在工具间流动

从 Claude Code 换到 Cursor,或交给队友,新 agent 对项目一无所知。

03

被厂商锁定

平台“记忆”存在别人服务器上。你读不到、改不了,也带不走。

04

被摘要抹掉

长会话被压缩成有损概述,真正需要的细节往往最先丢失。

核心理念

Kedu 不是记忆,而是记录层。

普通“记忆”回答模型记得什么。Kedu 回答我们为什么知道这件事、证据在哪里、是谁产生的、是否经过验证、由谁接着做下去。

CAPTURE

你要求记录,它写下来

可以记录整个会话,也可以只指向值得保留的具体内容。后台不会悄悄记录;由你决定保存什么。

PRESERVE

原样保存,不再摘要

Kedu 保存记录本身,包括证据、下一步、agent 身份和可检索词。

RETRIEVE

只取回相关记录

用确定性的关键词和正则检索所有记录;没有 embedding,也没有模糊猜测。

HAND OFF

下一个 agent 先读记录

Claude、Codex、Kiro、Cursor,或之后出现的工具,都从同一份书面记录开始。

REASON

基于可信笔记推理

模型基于你能打开、diff、审计的真实记录工作,而不是基于它自己臆造的记忆。

跨 agent 连续性

一份项目历史,所有 agent 都能读取。

Kedu 不试图成为 agent。它通过明确的 `kedu-log` 和 `kedu-search` skills,把同一份可持久交接记录交给不同 host,并保存在你的仓库和主目录里。

Claude Code Codex Cursor Kiro whatever comes next

Kedu 不是什么

刻意小而清楚。

记忆
它不让模型“记住更多”。它记录做过什么、证据在哪里,让下一个 agent 能验证并继续。
数据库
它不保存大批量数据。它记录数据在哪里:路径、数量、哈希和证据指针。
向量记忆 / RAG
没有 embedding,没有模糊相似度猜测。它靠精确过滤和关键词查找记录。
搜索引擎
它给出可能相关的候选记录;真正重要的是什么,由模型判断。没有排序打分。
聊天记录
不是对话流水。是关于决策、证据和下一步的有意、结构化记录。
Agent 框架
它不运行或调度 agent。它记录会话,并把上下文交接给你正在使用的任何 agent。
平台记忆
你的记录是你拥有的本地文件,不是保存在厂商服务器上的记忆。

五分钟上手

从 clone 到第一次交接。

从 Kedu GitHub 仓库安装,接入你的 agent,记录一个决定;然后在同一仓库打开另一个 agent,看它找回上下文。

目前仅支持源码安装。还没有 npm install -g kedubrew install kedupip install kedu;包管理器发行版会在预览期之后再做。
zsh — install & init
# 1 · 从源码安装 $ git clone https://github.com/jasonshrepo/kedu.git $ cd kedu && bash install.sh # 2 · 接入一个真实仓库 $ cd ~/path/to/project $ kedu init --host claude agent skills installed, records preserved locally # 3 · 在 agent 里保存并交接 /kedu-log 我们决定了什么、接下来该做什么 /kedu-search 上一个决定

本地所有权

记录存在你的项目和 ~/.kedu。可以读、diff、编辑、备份、脱敏。

捕获之后无损

一旦保存,记录就原样保留,不会被反复摘要成有损概述。

脱敏与干净卸载

写入时或事后都能清理密钥。卸载永远不会删除你的记录。

刻牍 · 把记录刻下来

不要再向每个 agent 重讲同一个 GitHub 项目。