ChatCrystal — заметки из диалогов с агентами
ChatCrystal
Локальная база знаний: импорт диалогов Claude Code, Cursor, Codex и других агентов, заметки, поиск по смыслу и память по MCP
- 62 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструмент читает локальные хранилища диалогов всех ваших агентов, а в них бывают ключи, пути и код
- Текст диалогов отправляется выбранным провайдерам модели и эмбеддингов при создании заметок
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/chatcrystalОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент читает локальные хранилища диалогов всех ваших агентов, а в них бывают ключи, пути и код
- Текст диалогов отправляется выбранным провайдерам модели и эмбеддингов при создании заметок
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ChatCrystal превращает разрозненные диалоги с кодинг-агентами в структурные заметки с названием, резюме, выводами, фрагментами кода и тегами. Импорт идет из 32 сред, среди них Claude Code, Claude Desktop, Codex CLI, Cursor, GitHub Copilot, Gemini CLI, Qwen Code, OpenCode, Cline и Roo Code, а на Windows читаются и сессии внутри WSL. Фоновая синхронизация сама подхватывает новые диалоги. Семантический поиск использует эмбеддинги и расширяет выдачу по связям, граф знаний строится по тегам и их совместной встречаемости, а заметки выгружаются в Markdown. Команды crystal search, crystal notes и crystal summarize работают из терминала, веб-интерфейс открывается на порту 3721, есть настольное приложение для Windows. Команда crystal mcp запускает MCP-сервер по stdio, через который агенты вспоминают сохраненный опыт и записывают новый. Модели для заметок и эмбеддинги настраиваются отдельно, а вариант для нескольких устройств разворачивается через Docker.
Для кого. Разработчикам, которые решают задачи с кодинг-агентами и хотят сохранять найденные решения и искать их по смыслу.
Подходит, если
- Решение, найденное в диалоге с Claude Code месяц назад, нужно быстро вспомнить
- Диалоги из разных агентов хочется собрать в один каталог заметок
- Агенту перед задачей полезно вспомнить прошлый опыт по проекту через MCP
- Знания требуется выгрузить в Markdown и увидеть граф тегов
- Командная база заметок нужна на нескольких устройствах через Docker
Не подходит, если
- Не настроен провайдер языковой модели: без него заметки не создаются
- Нельзя отправлять диалоги во внешние сервисы: суммаризация и эмбеддинги идут через выбранных вами провайдеров
- Нужна запись только одного проекта без импорта остальных диалогов: инструмент собирает все найденные источники
Пример запроса к агенту
Найди в моих заметках, как мы решали проблему с зависшей миграцией в прошлом месяце, и покажи итог и теги.Ограничения
Нужен Node.js 24 и новее, провайдер языковой модели для заметок и отдельный провайдер эмбеддингов для поиска: Claude, GPT и Qwen моделями эмбеддингов не служат. Данные хранятся локально, но текст диалогов уходит выбранным провайдерам при суммаризации. Диалоги часто содержат ключи и пути, поэтому перед импортом стоит оценить, что попадет в базу. Для Docker-развертывания по умолчанию используется образ ghcr.io/zengliangyi/chatcrystal. Версия на момент проверки 0.7.1, лицензия Apache-2.0.
Как отключить. Остановите сервер командой crystal serve stop, удалите пакет командой npm uninstall -g chatcrystal и уберите запись MCP из клиента. Базу заметок удалите вместе с папкой данных приложения.
Частые вопросы
Откуда импортируются диалоги?
Из 32 сред: Claude Code, Claude Desktop, Codex CLI, Cursor, Trae, GitHub Copilot, Gemini CLI, Qwen Code, OpenCode, Cline, Roo Code, Kilo Code, Continue и других. На Windows читаются и сессии внутри WSL.
Как поставить?
Для Windows есть установщик на странице релизов. Для остальных систем команда npm install -g chatcrystal, затем crystal serve -d и crystal import, интерфейс открывается на порту 3721.
Что нужно настроить для работы?
Два провайдера: языковой модели для заметок и эмбеддингов для поиска. Настройки у них раздельные, для генерации в README отдельно оговорена поддержка OrcaRouter.
Как подключить к агенту?
Запустите crystal mcp как MCP-сервер по stdio в настройках клиента. Через него агент ищет сохраненный опыт и записывает новый. Подробности в docs/MCP.md.
Можно ли развернуть для нескольких устройств?
Да, через Docker Compose: по умолчанию образ ghcr.io/zengliangyi/chatcrystal, версию можно закрепить переменной CHATCRYSTAL_IMAGE_TAG.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMinutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Заметки о встречах на Mac и MCP для агента: транскрипты в Markdown, поиск, итоги и задачи по записям, а бот на звонок не заходит
MCP-сервер и приложение для Mac: один локальный индекс репозиториев, сессий агентов и задач, поиск по смыслу и нити работы
MCP-эндпоинт рабочего пространства Salt на вашем сервере: агент создает страницы и базы, ищет и комментирует с правами человека.
Синхронизация буфера обмена между устройствами с встроенным MCP-сервером: агент читает вашу историю копирования, данные не уходят в облако
DoodleNote MCP — заметки встреч для агентов
DoodleNote MCP
MCP-сервер только для чтения: Claude Code, Claude Desktop и Codex ищут по локальным встречам, заметкам и транскриптам DoodleNote
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ChatCrystal — заметки из диалогов с агентами (эта карточка) | нет | 62 | |
| obsidian-second-brain | нет | 5 297 | вторая память на Obsidian, диалоги агентов сама не импортирует |
| Coding Agent Session Search (cass) | нет | 1 205 | быстрый поиск по сессиям агентов, без заметок и графа знаний |
Коротко о README
README представляет продукт как локальную базу знаний о разговорах с агентами, дает быстрый старт для настольной версии, CLI и Docker, список возможностей, команды, ссылки на документацию и статьи об устройстве и приватности.