Halofy — плагин
Плагин для Claude Code подключает агента к общей памяти организации с правами доступа, журналом аудита и подписанным удалением
- 319 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Хук остановки отправляет запись сессии на сервер, а в ней могут быть код, данные и секреты
- Ключ агента в переменной окружения открывает чтение и запись в память организации
- Плагин ставит MCP-сервер и хуки, которые срабатывают на старте и остановке каждой сессии
Установка
- Работает в
Ручная установка
git clone https://github.com/halofyai/halofy.git && cd halofy/kernel && npm ci && npm run serveПоднимает сервер локально, консоль открывается по адресу http://localhost:8787/console/login. Для постоянной работы с Postgres используйте руководство по самостоятельному развертыванию.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хук остановки отправляет запись сессии на сервер, а в ней могут быть код, данные и секреты
- Ключ агента в переменной окружения открывает чтение и запись в память организации
- Плагин ставит MCP-сервер и хуки, которые срабатывают на старте и остановке каждой сессии
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин для Claude Code из папки интеграций Halofy подключает агента к серверу общей памяти. При старте сессии хук ищет в памяти соглашения и решения проекта и подкладывает лучшие находки в контекст. При остановке второй хук отправляет запись сессии на сервер, а тот выделяет устойчивые факты, проверяет их и убирает дубли. Исправленный факт сервер закрывает и связывает с новой версией. История при этом сохраняется. Внутри сессии доступны MCP-инструменты `mem_search`, `mem_write` и `mem_read`. Сам Halofy — сервер, который стоит между знаниями организации и агентами. Личность, роль и пространство имен он определяет по ключу доступа на своей стороне и пишет любое действие в аудит. Удаление данных человека сервер подтверждает подписанным сертификатом. Хранилище по умолчанию встроенное PGlite, для постоянной работы подходит Postgres с pgvector. Для Codex есть установщик, который прописывает сервер в конфигурацию. Остальным клиентам нужен фрагмент настройки MCP.
Для кого. Командам, которые держат несколько агентов на общем знании и хотят управлять доступом, историей изменений и удалением данных на своем сервере.
Подходит, если
- Несколько агентов в команде должны видеть общие соглашения и решения проекта, а лишнего не видеть
- Нужна история изменений фактов: исправление закрывает старую запись и ссылается на новую
- Нужно доказуемо удалить данные клиента и получить подписанный сертификат
- Хотите, чтобы Claude Code в начале сессии получал из памяти правила проекта автоматически
- Для разных клиентов нужны разные ключи доступа с ролями и разделением по пространствам имен
Не подходит, если
- Нужна личная заметка для одного агента на одной машине: сервер, ключи и политики будут лишним
- Нужна двусторонняя синхронизация с Obsidian: интеграция только отправляет заметки на сервер
- Нет возможности поднять и сопровождать сервер на Node.js
Пример запроса к агенту
Подними локальный Halofy, выпусти ключ агента и подключи плагин halomem к Claude Code в этом проектеОграничения
Плагин работает только вместе с развернутым сервером Halofy: нужны переменные HALOMEM_URL и HALOMEM_API_KEY с ключом агента. Если переменных нет или сервер недоступен, хуки завершаются молча, и агент продолжает работу без памяти. Репозиторий распространяется под AGPL-3.0, у папки интеграций есть отдельный файл лицензии. По умолчанию сервер использует встроенное PGlite и детерминированную заглушку вместо модели. Настоящие модели Anthropic, OpenAI-совместимые и Azure OpenAI подключаются настройкой. Интеграция с Obsidian односторонняя.
Как отключить. Удалите плагин halomem через менеджер плагинов Claude Code (/plugin). Для Codex запустите установщик с флагом --remove, он уберет блок из config.toml. Ключ доступа можно отозвать в консоли Halofy.
Частые вопросы
Как подключить Halofy к Claude Code?
Поднимите сервер, задайте HALOMEM_URL и HALOMEM_API_KEY, затем выполните claude plugin marketplace add с путем к папке kernel/integrations и claude plugin install halomem@halomem-integrations.
Что плагин отправляет на сервер?
Хук остановки читает запись сессии и передает ее в /v1/mem/write. Сервер сам выделяет из текста устойчивые факты. Хук начала сессии, наоборот, запрашивает из памяти соглашения и решения проекта.
Что будет, если сервер недоступен?
Оба хука завершаются без вывода, а агент продолжает работать как обычно. Это заложено в плагин: при сбое связи он не блокирует сессию.
Работает ли Halofy с Cursor и Codex?
Да. Для Codex есть установщик codex/install.mjs. Для Cursor, VS Code, Cline, Gemini CLI, Claude Desktop и других клиентов консоль Halofy на экране Integrations генерирует нужный фрагмент настройки.
Чем Halofy отличается от Hindsight?
Hindsight хранит опыт и факты агента как систему долговременной памяти. Halofy добавляет к памяти организационный слой: роли, пространства имен, политики, аудит каждого обращения и подписанное удаление.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПамять для агентов на графе знаний: плагины для Claude Code и Codex, MCP-сервер и Python-библиотека
Операционный слой для Claude Code и Codex: единая команда /do, память проекта между сессиями, защитные хуки, телеметрия расходов и параллельные агенты
Локальная память для агентов: хранит переписку и файлы проекта дословно и находит нужное семантическим поиском через MCP
Плагин долгой памяти: запоминает решения, предпочтения и состояние задач между сессиями и подмешивает в запрос только нужное
Плагин самообучения для Claude Code, Codex и OpenCode: превращает исправления в правила, которым агент следует в следующих сессиях
Общая облачная память для агентов команды: сохраняет трассы сессий и превращает повторяющиеся приемы в скиллы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Halofy (эта запись) | да | 319 | ||
| Hindsight | да | API-ключ | 55 871 | система долговременной памяти агента без ролей, пространств имен и подписанного удаления |
| agent-memory | нет | 4 374 | память агента в Markdown-файлах с индексом SQLite на одной машине, без сервера и политик доступа |
Коротко о README
Halofy дает агентам, приложениям и операторам организации единые правила идентичности и политик по MCP и HTTP. В репозитории лежат ядро на TypeScript, веб-консоль и четыре коннектора: файловая система, Postgres, Obsidian и CSV.