К основному содержанию
плагин CX Codex

memory · dodo-labs-ai, codex — плагин для Claude Code: память и установка

memory — плагин для Claude Code с поиском MemForge и MCP-инструментами для работы с памятью. Он добавляет подсказки при старте сессии, а поиск запускается по запросу.

Apache-2.0 ★ 104 обновлён 2026-11-17

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add dodo-labs-ai/mem-forge
/plugin install memory@memforge
Открыть на GitHub

Что делает 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 от других авторов.

memory MemForge Team Плагин memory для Claude Code подключает агента к API MemForge через локальный MCP-прокси. Он передаёт правила работы на старте сессии и ищет контекст по запросу. CX Codex ★ 104звёзд репо para-memory-files paperclipai Скилл para-memory-files для сохранения знаний и фактов между сессиями ИИ-кодера. Организует память по методу PARA: проекты, области, ресурсы и архивы в отдельных файлах, с поиском по векторам и ключевым словам. CX Codex +1 1 900установок memory-reflect basicmachines-co Скилл memory-reflect для Claude Code разбирает свежие черновики и логи проекта, перенося принятые решения и правила в постоянные заметки. Сессия запускается по расписанию или по прямой команде. CX Codex +1 1 500установок memory-capture basicmachines-co Скилл memory-capture для Claude Code и Codex. Сохраняет итог обсуждения в заметку Basic Memory и обновляет её при повторном запуске в той же ветке. CX Codex +1 1 500установок memory-management aaron-he-zhu Скилл memory-management для Claude Code ведёт рабочую память проекта: сохраняет, находит, объединяет и архивирует заметки. Подключается к запросам о контексте между сессиями и удалении записей. CX Codex +1 1 200установок memory-intake nhadaututtheky Скилл memory-intake для Claude Code превращает сырые заметки и обрывки разговоров в типизированные записи памяти с тегами и приоритетом. Раскладывает хаос по полкам. CX Codex +1 780установок video-memory oxbshw Скилл video-memory для Claude Code ищет ответы в видео, просмотренных раньше или в разных сессиях. Он подключается к вопросам о содержании записей и темах из нескольких видео. CX Codex +1 748установок

Из того же набора8

memory Хук memory для Claude Code подгружает инструкции MemForge и инструменты MCP при старте сессии. Срабатывает автоматически при запуске, возобновлении или сжатии контекста диалога. CX Codex ★ 104звёзд репо memory Плагин memory для Claude Code подключает агента к API MemForge через локальный MCP-прокси. Он передаёт правила работы на старте сессии и ищет контекст по запросу. CX Codex ★ 104звёзд репо lifecycle-canary-convergence Скилл lifecycle-canary-convergence для Claude Code сводит проверку жизненного цикла Memory к инвентаризации, пробному запуску, применению и аудиту. Запускается перед повторной попыткой или canary. CX Codex +1 ★ 104звёзд репо self-hosted-release-validation Скилл self-hosted-release-validation для Claude Code проверяет селф-хостед релизы через чистый сценарий Docker Compose. Оценивает сохранение данных в SQLite и готовность сборки к публичной бете. CX Codex +1 ★ 104звёзд репо memforge-setup Скилл memforge-setup для Claude Code настраивает привязку проекта к рабочему пространству MemForge. Он запускается по просьбе привязать или отвязать проект либо разобраться с выбором пространства. CX Codex +1 ★ 104звёзд репо plugin-release-validation Скилл plugin-release-validation для Claude Code проверяет релизы плагина памяти MemForge через удалённый маркетплейс. Включается при выпуске RC-тегов, смене версий и тестировании хуков с MCP. CX Codex +1 ★ 104звёзд репо memforge-daemon-setup Скилл memforge-daemon-setup для Claude Code устанавливает и настраивает локальный демон MemForge как пользовательскую службу macOS или Linux. CX Codex +1 ★ 104звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой