Mnemonic Proxy CLI
Прокси между агентом и локальной моделью: старые выводы уходят в архив на диске, а модель достает их инструментом recall
- 68 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Прокси видит весь трафик агента и хранит открытым текстом в SQLite все, что агент прочитал, включая секреты
- Прокси слушает локальный адрес без аутентификации, поэтому открывать его в общую сеть нельзя
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mnemonic-proxyОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Прокси видит весь трафик агента и хранит открытым текстом в SQLite все, что агент прочитал, включая секреты
- Прокси слушает локальный адрес без аутентификации, поэтому открывать его в общую сеть нельзя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mnemonic Proxy стоит между вашим кодирующим агентом и сервером модели и дает работать с локальной моделью часами даже при маленьком окне контекста. Без него длинная сессия заканчивается автосжатием: агент продолжает по пересказу пересказа, забывает детали и повторяет уже сделанную работу. Прокси выбирает другой путь. Когда промпт растет, старые выводы инструментов и рассуждения заменяются однострочной квитанцией с идентификатором, а исходный текст слово в слово сохраняется в локальном архиве SQLite. Модель получает инструмент `recall`, которым ищет в архиве и читает любой фрагмент. Эти вызовы прокси отрабатывает сам, агент их не видит. Если окно все равно заполняется, модель пишет заметки передачи и продолжает в новом сегменте, а старые сообщения остаются доступными для поиска. На серверах, которые умеют сохранять состояние движка, возобновление сессии занимает секунды. Прокси работает с любым сервером, совместимым с OpenAI: Strata, llama-server, Ollama, LM Studio, Unsloth, ds4-server. Агентов подключают по адресу и отключают у них собственное сжатие: Claude Code, Codex, opencode, pi, Hermes Agent, DeepSeek Harness и Continue. Ставится командой `pip install mnemonic-proxy`, проверка перед запуском `mnemonic-proxy check`, демонстрация без модели `uvx mnemonic-proxy demo`.
Для кого. Тем, кто запускает кодирующего агента на локальной модели с небольшим контекстом и устал от автосжатия в длинных сессиях.
Подходит, если
- Сессия идет три часа на одной видеокарте на 12 ГБ, а контекст модели не вмещает всю историю
- Агент после сжатия теряет подробности и повторяет исследование, которое уже делал
- Нужно вернуть первую версию блока кода дословно, без краткого пересказа
- Сервер модели умеет сохранять состояние, и надо быстро возобновить длинный разговор
Не подходит, если
- Вы используете облачную модель с огромным окном: проблема автосжатия там встает реже
- У модели нет вызова инструментов: без него `recall` недоступен
- Сервер модели стоит в общей сети: прокси слушает `127.0.0.1` и не имеет авторизации
Пример запроса к агенту
Вспомни через recall, какой код я показывал в самом начале сессии, и верни первую версию функции дословноОграничения
- Нужны Python 3.10 или новее, запущенный сервер модели с окном не меньше 16 тысяч токенов (лучше 32 тысяч) и модель, умеющая вызывать инструменты.
- Прокси не делает модель умнее: точный текст еще не значит, что модель станет его искать или найдет в нужном месте. Поиск идет по словам, а цифры взяты из единичных замеров на оборудовании автора.
- Архив хранит открытым текстом все, что видел агент, включая секреты: папку `data` нужно защитить. Прокси слушает `127.0.0.1` без аутентификации.
- Автосжатие у агента нужно отключить, иначе два менеджера контекста конфликтуют; для Ollama и LM Studio контекст задают 32768.
Как отключить. Прокси останавливают, а адрес агента возвращают на сервер модели; пакет убирает `pip uninstall mnemonic-proxy`. Папку `data` с архивом удаляют вручную.
Частые вопросы
Как запустить Mnemonic Proxy?
Выполните `pip install mnemonic-proxy`, затем `mnemonic-proxy check --upstream http://127.0.0.1:8095 --port 8096 --data ./data` и сам запуск без `check`. Агенту укажите адрес `http://127.0.0.1:8096/v1`.
Как подключить Claude Code?
Задайте `ANTHROPIC_BASE_URL=http://127.0.0.1:8096` без суффикса `/v1` и `DISABLE_AUTO_COMPACT=1`, чтобы два менеджера контекста не конфликтовали.
Что такое recall?
Инструмент модели для поиска в архиве и чтения любого сохраненного фрагмента. Прокси отвечает на эти вызовы сам, агент их не видит.
Чем это лучше пересказа модели?
В тесте AgentLongBench на 100 вопросов про старые выводы инструментов модель ответила верно на 86 с прокси и окном 32 тысячи, на 47 с пересказом и на 69 с полной историей в большем окне. Повтор дал 85, 57 и 75.
Можно ли попробовать без модели?
Да, `uvx mnemonic-proxy demo` за минуту показывает архив и `recall` на сценарной модели-заглушке.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыParitok — прокси между кодинг-агентом и API модели, который сжимает запросы и сокращает счет за входные токены.
Одна программа дает Claude Code, Codex и Cursor общую память между сессиями: граф знаний лежит локально, ключи API не нужны
Локальная память для Claude Code, Codex и Cursor Agent: учится на вашей активности на Mac и отдает агентам контекст со ссылками на источники по MCP
Двойная память для агентов: граф знаний на вашей машине, поиск по запросу и подсказки до запроса, сквозные между сессиями.
Локальная память с доказательствами: что агент узнал и откуда, а при исправлении источника зависимые записи снимаются
mem-agent-mcp — локальная память для агента
mem-agent-mcp
MCP-сервер, который отвечает на вопросы по вашим заметкам в стиле Obsidian через локальную модель mem-agent от Dria.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Mnemonic Proxy (эта карточка) | нет | 68 | |
| fast-jev-compaction | нет | 7 952 | Тот плагин вырезает устаревшие вызовы из истории, а Mnemonic Proxy выносит выводы в архив на диске и отдает модели через recall. |
| Anamnesis | нет | 188 | Anamnesis хранит память между сессиями, а Mnemonic Proxy хранит дословную историю внутри одной длинной сессии. |
Коротко о README
README объясняет проблему автосжатия, описывает прокси и инструмент `recall`, приводит замеры, ограничения, быстрый старт, таблицу подключения агентов, принцип работы и приватность.