dsh-memoir DSH plugin

dsh-memoir captures what a session did, pitfalls encountered, and next steps as persistent project memory. It automatically prompts the agent to summarize after each productive turn, stores structured data globally and as a git-friendly MARKDOWN file, and injects the memory into new sessions so future agents inherit past experience. A Web panel allows browsing, searching, and manually adding or deleting memories.

developer-tools skills-workflows

How to install the dsh-memoir DSH plugin

dsh plugin --profile web add github:Qinling-Melon-Farmers/dsh-memoir

Copying does not run this command. Review the repository and version before installing the dsh-memoir DSH plugin.

dsh-memoir DSH plugin data source

dsh-memoir DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-memoir DSH plugin can do

Auto-distill: monitors turn-stopping and prompts agent to record memory after each turn with tool calls.
Tools: memoir_record to record (work, lessons, actions, note), memoir_read to retrieve (project/global/all).
Persistent storage: global JSON index (~/.dsh/dsh-memoir.json) and per-project PROJECT_MEMORY.md.
Automatic injection: project memory auto-injected into system prompt of new sessions.
Web GUI: side panel entry, project/global views, full-text search, manual add/delete.

Where the dsh-memoir DSH plugin fits

Repeated environment pitfalls (encoding, terminal errors) – record a lesson with fix commands.
Project conventions and red lines (no emoji, run tests before release) – record as actions.
Root cause of hard-to-find bugs – record as lessons to avoid re-diagnosis.
Deployment checklist – record as actions for new sessions.
Cross-project reuse of experience – search via global tab or memoir_read.

Who the dsh-memoir DSH plugin is for

DSH users who want to avoid repeating troubleshooting across sessions.
Developers working on projects with multiple contributors or long-lived tasks.
Teams that need to maintain project-specific knowledge for AI agents.

dsh-memoir DSH plugin limitations

Does not fix underlying terminal encoding or console issues; only records the root cause and fix.
Project memory file is regenerated from the source JSON; manual edits to PROJECT_MEMORY.md may be lost if not reflected in the source.
Only works in DSH environment with plugin installed.

dsh-memoir DSH plugin: from the repository README

Quoted from the Qinling-Melon-Farmers/dsh-memoir README, the upstream source of the dsh-memoir DSH plugin. Copyright remains with the original authors.

把「一个会话做了什么 / 踩了什么坑 / 下一步怎么走」沉淀为**项目持久化记忆**，并作为**未来 AGENTS 的行动指南**自动注入后续会话；插件开启后**每轮有实际工作的回合结束时自动提醒 agent 归纳沉淀**，另有 Web GUI 可视化面板浏览、检索与维护记忆。 - **自动收尾（auto-distill）**：监听 `agent/turn-stopping`，一轮有工具调用、且尚未记录过记忆的回合结束时，自动 steer 一句归纳提示，让 agent 用 `memoir_record` 把该轮工作沉淀为项目记忆（无实质工作的回合不打扰、子代理会话不打扰、每回合最多一次）。 - **归纳总结**：`memoir_record` 归纳工作记录、经验教训与行动指南。 - **持久记忆**：项目级写入 `<工作区>/PROJECT_MEMORY.md`（随 git 提交）；结构化源数据存全局索引 `~/.dsh/dsh-memoir.json`（跨项目检索）。 - **自动行动指南**：新会话开始时，插件把本项目的 `PROJECT_MEMORY.md` 自动注入 system prompt，未来 AGENTS 无需手翻文档即可继承既往经验。 - **可视化面板**：侧边栏「记忆」入口，中心面板提供项目 / 全局两个视图、全文检索、手动记录与删除。 ## 设计背景 DSH 的 agent 会话本身是「失忆」的：新会话不记得上一个会话踩过的坑。现实中的典型代价是**反复排查同类问题**——控制台中文乱码要查一次、某个终端的转义错误要查一次、某个工具的环境配置又要查一次；`AGENTS.md` 这类人工维护的说明文件要么没人更新、要么被塞得臃肿。社区已有的记忆类插件各有侧重：`dsh-memory` 侧重无损引用式检索、`dsh-mnemon` 依赖外部 Mnemon 服务、`distill` 自动蒸馏但落成 skill 文件、缺少可视化面板。 dsh-memoir 想补的是一个**开箱即用、纯本地、零外部依赖**的记忆层，把「记录 → 存储 → 自动注入 → 可视化维护」串成闭环： 1. **记录**：agent 在任务收尾调用 `memoir_record`（或插件每轮工作结束自动提醒）； 2. **存储**：结构化 JSON 全局索引为源，`PROJECT_MEMORY.md` 为可读渲染（随 git 提交、人也能看）； 3. **注入**：新会话开始时按项目自动注入记忆，未来 AGENTS 无需手翻文档即继承经验； 4. **维护**：Web 面板可检索、补录、删除，与 agent 写的是同一份数据。 ## 能力 | 工具 | 作用 | | --- | --- | | `memoir_record(section, title?,

Read the full READMERepository license: Apache-2.0

dsh-memoir DSH plugin questions

How do I install dsh-memoir?

Run `dsh plugin --profile web add github:Qinling-Melon-Farmers/dsh-memoir` in your terminal. Then restart DSH with `dsh web`. You can verify the plugin is active by running `dsh --profile web --dump-config` and checking the final composition. After restart, a "Memory" entry should appear in the sidebar.

Will the agent automatically remember past sessions?

Yes, if auto-distill is enabled (default). After each turn with tool calls, the plugin prompts the agent to record a memory using `memoir_record`. The memory is stored in PROJECT_MEMORY.md and automatically injected into the system prompt of new sessions, so the agent inherits the experience.

Can I manually add memories without the agent?

Yes, open the Web panel via the sidebar "Memory" entry. In the project memory tab, click "Add memory" to record a new entry with category, title, and content. This writes to the same data source as the agent's tool calls.

How do I search across all projects?

Use the global tab in the Web panel, which shows all project memory buckets. You can also use the `memoir_read` tool with `scope: 'global'` and an optional `query` parameter to filter by keyword.

What happens if I edit PROJECT_MEMORY.md manually?

The file is regenerated from the structured JSON source (`~/.dsh/dsh-memoir.json`). Manual edits to the markdown file will be overwritten the next time the source is regenerated. To add or modify memories, use the panel or the `memoir_record` tool to keep the source consistent.