元忆 yotta-memory — Agent Plugin
File-based agent memory with permission boundaries, packaged as an Agent Plugin with a built-in MCP server (remember / recall / search / context).
English
This repository is a standalone Agent Plugins 1.0 plugin. It packages one skill and one MCP server in the standard layout (plugin.json, skills/, mcp.json).
Install
Codex (verified)
codex plugin marketplace add YottaMeta/yotta-memory-plugin
codex plugin add yotta-memory@yotta-memory
Other compatible clients
Agent Plugins defines the package format, not a universal installer command. Use your client’s official setup instructions:
Codex is verified by YottaMeta. Other clients are linked from the official Agent Plugins compatibility page and are not yet verified here.
What you get
- Skill —
yotta-memoryskill instructions (skills/yotta-memory/SKILL.md) - MCP server — started automatically by the client (stdio; requires Node.js)
Identity handshake (host substitution)
This plugin ships mcp.json with identity placeholders (${AGENT_ID}, ${AGENT_KEY_FILE}) and a launcher that resolves them at start-up. If the client replaces the placeholders, those values win; otherwise the launcher falls back to environment variables and to <PLUGIN_DATA>/identity.json.
${AGENT_ID}— this agent's unique id (single path segment; no/,\,..).${AGENT_KEY_FILE}— path to theagent_keyfile for that id, created by the user viayotta-memory viewandyotta-memory key claim <id>; the default is<AI_HOME>/.yotta-memory-agent-key.
Without a resolved identity the server still starts, but private memory operations (PREF / BOUND / COMMIT) fail closed and the launcher prints an actionable binding guide; public FACT operations keep working. To bind, authorize in yotta-memory view, then run yotta-memory key claim <id> --to <PLUGIN_DATA>, or write <PLUGIN_DATA>/identity.json ({"agent_id":"<id>"}). The stdio identity contract still accepts only --agent-id + --agent-key-file.
Boundaries
- The MCP server runs fully local over stdio; no telemetry, no remote calls from the plugin itself.
- If the required runtime is missing, the MCP component may fail to start; the skill payload remains available.
- The skill payload is copied from the source repository release; for full documentation see YottaMeta/yotta-memory.
Source
Upstream skill repository: YottaMeta/yotta-memory Plugin repository: YottaMeta/yotta-memory-plugin
License
MIT — see LICENSE and the license inside the skill payload.
中文
本仓库是一个独立的 Agent Plugins 1.0 插件，按标准目录结构打包一项技能和一个 MCP server（plugin.json、skills/、mcp.json）。
安装
Codex（已实测）
codex plugin marketplace add YottaMeta/yotta-memory-plugin
codex plugin add yotta-memory@yotta-memory
其他兼容客户端
Agent Plugins 只定义包格式，不定义统一安装命令。请按你所用客户端的官方说明接入：
Codex 已由 YottaMeta 实测；其他客户端仅链接官方说明，尚未在本仓库逐项实测。
内容
- 技能 —
yotta-memory技能指令（skills/yotta-memory/SKILL.md） - MCP server — 由客户端自动启动（stdio；需要 Node.js）
身份装配（宿主替换占位符）
本插件发布的 mcp.json 带身份占位符（${AGENT_ID}, ${AGENT_KEY_FILE}），并自带启动器在运行时解析身份：客户端已替换时优先用替换值，未替换则回退到环境变量与 <PLUGIN_DATA>/identity.json。
${AGENT_ID}— 本智能体的唯一 id（单段名称，禁止/、\、..）。${AGENT_KEY_FILE}— 该 id 的agent_key文件路径，由用户执行yotta-memory view授权后经yotta-memory key claim <id>领取，默认<AI_HOME>/.yotta-memory-agent-key。
宿主未替换身份时 server 仍可启动，但私密记忆（PREF / BOUND / COMMIT）操作 fail-closed 并给出可执行的绑定指引，公共 FACT 不受影响。绑定方式：在 yotta-memory view 授权后执行 yotta-memory key claim <id> --to <PLUGIN_DATA>，或写入 <PLUGIN_DATA>/identity.json（{"agent_id":"<id>"}）。stdio 身份契约仍只接受 --agent-id + --agent-key-file。
边界
- MCP server 完全本地 stdio 运行；插件本身不做遥测、不发起远程调用。
- 若运行时缺失，MCP 组件可能启动失败；技能内容仍可使用。
- 技能内容来自源仓库发布版；完整文档见 YottaMeta/yotta-memory。
来源
上游技能仓库：YottaMeta/yotta-memory 插件仓库：YottaMeta/yotta-memory-plugin
许可证
MIT — 见 LICENSE 与技能目录内许可证。
