AI编程代理持久记忆工具

Muninn为AI编程代理提供持久记忆功能,通过MCP协议实现跨会话知识积累,解决代码编辑中的状态丢失问题。

  • by ravnltd
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ravnltd/muninn

使用说明

缪宁级

你的AI编码代理在会话之间会忘记一切。穆尼恩解决了这个问题。

npx muninn-ai

Muninn通过以下方式为AI编码代理提供持久内存 主控程序在每次编辑之前,代理人都知道什么是脆弱的,做出了什么决定,以及上次发生了什么。每次会议结束后,它都会写回所学到的东西。知识会自动合成。

适用于:Claude Code、Cursor、Windsurf、Continue.dev和任何兼容MCP的工具。


问题

AI编码代理是无状态的。每个会话都从零开始:

  • 他们打碎东西 --编辑一个关键文件,却不知道它很脆弱
  • 他们自相矛盾 --选择与3个会话前不同的模式
  • 他们重复错误 --重新引入已经修复的错误
  • 他们失去了背景 --遗忘 为什么 某事是以某种方式完成的

4工具

Muninn向您的AI代理公开了4个工具:

工具 目的
recall 预编辑背景——脆弱性、共同变革者、相关决策、未决问题、爆炸半径
remember 记录决策和学习结果——自动分类,可跨会话搜索
track Bug生命周期——发现时添加,修复时解决,相关时浮出水面
muninn 其他一切——状态、重新索引、脆弱文件、决策结果

什么化合物

Muninn每次训练都变得更聪明:

  • 脆弱性评分 --依赖项、测试覆盖率、变化速度、错误历史、复杂性和导出曲面的加权组合
  • 文件相关性 --跟踪哪些文件一起更改,以预测共同更改并警告错过的更新
  • 学习毕业 --被证明是正确的模式会得到推广;矛盾的被归档
  • 决策依据 --架构选择与结果相关,因此代理知道哪些有效,哪些无效

快速开始

选项1:npx(推荐)

npx muninn-ai

安装Bun(如果需要),克隆仓库,注册MCP服务器,并设置挂钩。一个命令。

选项2:手动安装

git clone https://github.com/ravnltd/muninn.git ~/.local/share/muninn
cd ~/.local/share/muninn && ./install.sh

首映

在第一次会话中,Muninn会自动索引您的git历史记录(最近100次提交),因此 recall 立即返回有用的上下文。无需设置。

多编辑器支持

安装后,Muninn会自动检测并配置:

  • 克劳德代码 --MCP服务器+会话挂钩
  • 光标 — .cursor/mcp.json
  • 帆板运动 — .windsurf/mcp.json
  • Continue.dev — .continue/config.json

或手动注册:

muninn setup --list    # See what's detected
muninn setup --all     # Configure all detected editors

建筑

Bun+TypeScript+SQLite(通过libsql/sqld)。通过stdio作为MCP服务器运行。本地模式存储所有内容 .muninn/ 每个项目。HTTP模式连接到共享的sqld实例,用于多机设置。

许可证

仅限AGPL-3.0 --免费使用、修改和共享。如果将修改后的版本作为网络服务运行,则必须发布源代码。


与合作建立 克劳德代码.