memory · dodo-labs-ai, codex — плагин для Claude Code: память и установка
memory — плагин для Claude Code с поиском MemForge и MCP-инструментами для работы с памятью. Он добавляет подсказки при старте сессии, а поиск запускается по запросу.
Apache-2.0 ★ 104 обновлён 2026-11-17
/plugin marketplace add dodo-labs-ai/mem-forge
/plugin install memory@memforgeЧто делает memory
Плагин подключает MCP-прокси к API MemForge и добавляет статичные подсказки при старте, возобновлении или уплотнении сессии. Прокси умеет искать и читать воспоминания, получать связанные файлы и создавать новую личную память после подтверждения. Автоматически он ничего не записывает.
Для работы нужен доступ к MemForge API. По умолчанию используется локальный сервер http://127.0.0.1:8765/api/v1; для другого сервера задают MEMFORGE_API_URL в ~/.codex/config.toml, а при авторизации токен передают через MEMFORGE_API_TOKEN. Ручной блок [mcp_servers.memforge] добавлять не нужно: регистрацию MCP выполняет плагин.
Какие задачи решает
- найти воспоминания по теме через MemForge
- получить подробности и исходный файл для найденной памяти
- сохранить новую личную память после подтверждения
- просмотреть недавние воспоминания за заданный период
Примеры запросов агенту
- Найди в MemForge воспоминания о
<topic>и покажи подробности по подходящему результату. - Получи исходный файл для этой памяти и покажи локальный путь.
- Запомни это как личную память и сначала покажи, что именно будет сохранено.
Как установить memory
Через маркетплейс плагинов
/plugin marketplace add dodo-labs-ai/mem-forge/plugin install memory@memforgeПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о memory
Как установить memory в Claude Code?
Выполни команды по порядку: /plugin marketplace add dodo-labs-ai/mem-forge, затем /plugin install memory@memforge.
Что делает memory?
Плагин подключает MCP-инструменты MemForge для поиска и чтения памяти, а также добавляет подсказки при старте сессии. Новую память он записывает только после подтверждения.
Что нужно для работы memory?
Нужен доступ к MemForge API. По умолчанию используется локальный адрес http://127.0.0.1:8765/api/v1; для другого сервера задают MEMFORGE_API_URL, а при Bearer-аутентификации отдельно MEMFORGE_API_TOKEN.
Исходный текст
memforge-memory · Apache-2.0
# MemForge Memory for Codex This plugin connects Codex to a MemForge API through a thin local MCP proxy for memory tools, and adds MemForge usage guidance when a session starts. The packaged runtime and plugin version is `0.2.0-beta.4`. With no routing variables, the plugin targets local OSS at `http://127.0.0.1:8765/api/v1`. Otherwise set the origin in `~/.codex/config.toml`. `MEMFORGE_API_URL` must be an HTTP(S) origin without an API path. Set `MEMFORGE_API_TOKEN` separately when bearer authentication is required. ```toml [memforge] MEMFORGE_API_URL = "https://memforge.example.com" MEMFORGE_API_TOKEN = "..." ``` The same `/api/v1` surface is used for OSS and Cloud. Call `list_workspaces` to discover accessible workspaces when useful, then pass optional `workspace_id` to any data tool for a one-request override. It may be omitted when the account has exactly one accessible workspace or the project has a user-confirmed local binding. Use the `memforge-setup` skill to bind a Git repository or ordinary directory. Use `memforge-daemon-setup` when the agent should securely install, configure, verify, troubleshoot, or remove the managed local collection daemon. Repository context remains provenance attribution; it never selects or authorizes a workspace. Do not add a manual `[mcp_servers.memforge]` block. The plugin's `.mcp.json` registers the MCP server; duplicating it in `config.toml` can pin Codex to a stale plugin cache path after upgrades. The bundled MCP proxy does not need a local MemForge CLI or local-DB MCP process. It forwards search, current recent-Memory listing, memory detail, memory write, and Review calls through the configured immutable target. `get_resource(mode="file")` is handled locally so returned `local_path` values point to the agent machine. ```text Codex MCP stdio -> plugin-local proxy -> HTTP(S) MemForge API get_resource(mode=file) -> ~/.memforge-agent/artifacts -> local_path ``` The proxy negotiates Codex's request-scoped `codex/sandbox-state-meta` capability. Codex then attaches the current task environment's `sandboxCwd` to each MCP tool call, allowing the proxy to derive a normalized Git remote without relying on a process-global directory. An explicit `repository_context.working_directory` remains available for other hosts and takes precedence when supplied. Compatible MCP Roots are attribution fallbacks. Local paths are discarded before OSS or Cloud calls; malformed negotiated or explicit context fails before HTTP instead of silently reading another workspace. Install from GitHub (no checkout required): ```bash codex plugin marketplace add dodo-labs-ai/mem-forge codex plugin add memory@memforge ``` Start a new Codex session after install. To push a local folder as a source, open the MemForge Admin UI, choose **Add Source -> Local Repository**, and run the printed CLI command. ```bash # optional codex mcp get memforge --json ``` Try a search: ```text Use MemForge to search for "<topic>". If source evidence matters, call get_memory on the relevant result before citing source details. ``` List current Memories observed from active sources during a resolved time window without inventing a topic query: ```text Use MemForge list_recent_memories for 2026-07-21T00:00:00+08:00 through 2026-07-28T00:00:00+08:00. This is a current-Memory view, not a source changelog. Follow next_cursor with the same filters until has_more is false. ``` Fetch backing evidence: ```text Search MemForge for "<topic>". Call get_memory for the relevant memory, then call get_resource with mode="file" on the best content_url or pdf_url and show the local_path. ``` The plugin registers one hook, `SessionStart`. It adds static MemForge usage guidance to a new, resumed or compacted session, and it makes no network call and writes no local state. Per-prompt memory retrieval is left to the MCP `search` tool, which fetches query-aware context on demand. The bundled MCP proxy exposes tools such as `search`, `list_recent_memories`, `get_memory`, and `get_resource`. `get_resource` fetches `content_url` / `pdf_url` artifacts through `MEMFORGE_API_URL`; in `file` mode it writes the artifact to `~/.memforge-agent/artifacts`. The plugin captures nothing on its own. To keep something, ask Codex to remember it: the agent shows a preview, and after you confirm it writes one private Memory with the MCP `create_memory` tool. ## Upgrading from 0.2.0-beta.1 or earlier Earlier plugin releases uploaded redacted session windows automatically. That capture is removed, and MemForge refuses those uploads. Update the plugin and restart Codex: ```bash codex plugin marketplace upgrade memforge codex plugin add memory@memforge ``` After the update: - You can delete `queue.sqlite`, `queue.sqlite-wal`, `queue.sqlite-shm` and `worker.lock` in `~/.memforge-agent`; nothing reads them. Keep `~/.memforge-agent/artifacts` if you use `get_resource(mode="file")`. - A `hook_workspace_id` entry in `~/.memforge/workspace-bindings.json` is ignored. The `memforge-setup` skill reports it and can remove it. - Memories captured from earlier sessions belong to the Codex Session Source. A MemForge server on a release after 0.2.0b2 retires that Source when it upgrades, with the Memories no other Source supports. On a server still on 0.2.0b2, delete the Source in the admin UI to retire it the same way. ## Troubleshooting **Codex shows `MemForge hook skipped: /hooks/receipts returned HTTP 410` or `MemForge hook skipped: /hooks/receipts returned HTTP 404` at the end of a turn or at compaction.** An earlier plugin release is still installed, and MemForge no longer accepts its session uploads: a 0.2.0b2 server answers `410`, and a later server, which no longer has the upload routes, answers `404`. Update the plugin with the commands above and restart Codex.
© MemForge Team · Apache-2.0 · dodo-labs-ai/mem-forge
Похожие плагины
Все плагины по теме «Настройка агента: память, контекст, субагенты» →Сначала — memory от других авторов.