MindOS — общая база знаний для людей и агентов
MindOS
Локальная база заметок в Markdown с MCP-сервером и скиллами: Claude Code, Cursor, Codex и Gemini CLI читают один и тот же контекст
- 704 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агенты читают и записывают файлы вашей базы знаний, а там часто лежат личные данные и инструкции
- HTTP-режим MCP открывает базу по сети: доступ держится на токене Bearer и ограничении путей, поэтому токен нельзя публиковать
Установка
- Работает в
Ручная установка
npm install -g @geminilight/mindos@latest && mindos onboardСтавит CLI и локальный веб-интерфейс, мастер настройки спросит путь к базе, порты, авторизацию и поставщика моделей. Есть и настольное приложение.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агенты читают и записывают файлы вашей базы знаний, а там часто лежат личные данные и инструкции
- HTTP-режим MCP открывает базу по сети: доступ держится на токене Bearer и ограничении путей, поэтому токен нельзя публиковать
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MindOS хранит ваши заметки обычными Markdown-файлами на диске и отдает их агентам через MCP-сервер с транспортами stdio и HTTP. Установка ставит CLI `mindos` и локальный веб-интерфейс, а команда `mindos mcp install` прописывает MCP и упакованный скилл MindOS в настройки агентов за один проход. Проверить результат можно командой `mindos doctor agents`: она показывает, видит ли агент сервер по-настоящему. Один раз записанный профиль, проекты и инструкции доступны всем подключенным агентам, и вам не нужно пересказывать их при смене инструмента. Результат работы агентов возвращается в базу заметками и процедурами SOP. Для людей есть рабочая область в браузере и настольном приложении: поиск, редактирование, граф ссылок, обратные ссылки, импорт файлов с авторазбором, веб-клиппер для сохранения страниц. Встроенный агент ведет диалог с базой, а YAML-воркфлоу исполняют повторяемые сценарии агентов. Инспектор агента показывает вызовы инструментов временной шкалой, а Git-синхронизация делает правки людей и агентов обратимыми. В папке `plugins/mindos` лежит плагин для Claude Code и Codex с рабочими представлениями людей и задач.
Для кого. Для тех, кто пользуется сразу несколькими агентами, устал повторять им контекст проекта и хочет хранить его в обычных файлах под своим контролем.
Подходит, если
- Вы переключаетесь между Claude Code, Cursor и Codex и хотите, чтобы профиль и правила проекта лежали в одном месте
- Нужна память, которую можно открыть, прочитать и поправить руками: заметки лежат в Markdown на вашем диске
- После долгого диалога с агентом хочется сохранить вывод в виде повторно используемой процедуры SOP
- Нужен журнал вызовов инструментов агента в виде фильтруемой временной шкалы, для этого служит Agent Inspector
- Вы собираете страницы из интернета в базу знаний одним нажатием с помощью веб-клиппера
Не подходит, если
- Нужна готовая облачная служба заметок с синхронизацией между телефонами: MindOS локальный, а синхронизацию между устройствами дает Git
- Достаточно одного файла `CLAUDE.md` в проекте: база знаний с графом, GUI и MCP в этом случае избыточна
- Нужна устойчивая многоагентная координация: протоколы ACP и A2A автор называет ранними, а надежные почтовые ящики и доски задач еще экспериментальные
- Вам нужны только возможности, уже выпущенные в npm: представления людей и задач, личные страницы и блоки пока лежат в исходниках
Пример запроса к агенту
Вот мое резюме. Прочитай его и разложи сведения по папкам в MindOS, а потом сохрани итоги нашего разговора как процедуру SOPMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Ограничения
Новые возможности отмечены автором как кандидаты в исходниках: представления людей и задач, личные страницы, свои блоки на HTML и CSS с ограниченным Worker-кодом. В опубликованную версию на npm они пока не входят. Для плагина с представлениями нужны macOS или Linux с Node.js 22.19 и новее, а рантайм обязан сообщать `capabilityVersion: 1` в `mindos views doctor`.
Установка пакета идет командой `npm install -g @geminilight/mindos@latest`, есть и настольное приложение для macOS, Windows и Linux. Встроенный агент работает на подключенном вами поставщике моделей, ключ нужен для него, но не для плагина: хост подставляет собственного агента. Доступ к базе защищен токеном Bearer и песочницей путей, а файл `INSTRUCTION.md` закрыт от записи.
Плагин из каталога `plugins` ставится из локального клона командами маркетплейса Claude Code, а не из общего каталога. После установки хост нужно переподключить.
Как отключить. Уберите запись mindos из настроек MCP каждого агента, а плагин снимите командой `claude plugin uninstall mindos@mindos-local`. Удаление плагина оставляет локальные записи, рантайм и установку для второго хоста. Сам пакет снимается командой `npm uninstall -g @geminilight/mindos`, заметки в вашей папке остаются.
Частые вопросы
Как установить MindOS и подключить его к Claude Code?
Поставьте пакет `npm install -g @geminilight/mindos@latest`, пройдите мастер `mindos onboard`, затем выполните `mindos mcp install -g -y`. Команда настроит MCP и скилл в глобальной области. Проверка: `mindos doctor agents`.
Где лежат мои заметки?
В обычных Markdown-файлах в папке, которую вы выбрали в мастере. Настройки сохраняются в `~/.mindos/config.json`. Файлы можно открыть любым редактором, а Git-синхронизация делает правки обратимыми.
С какими агентами работает MindOS?
С собственным встроенным агентом и с внешними: Claude Code, Cursor, Gemini CLI и Codex подключаются через MCP по stdio или HTTP. Полный список и ручные настройки автор вынес в `docs/en/supported-agents.md`.
Нужен ли ключ API?
Для встроенного агента и ИИ-разбора файлов нужен ключ поставщика моделей, который вы указываете при настройке. Для подключения внешних агентов по MCP отдельный ключ не требуется, они используют собственные модели.
Есть ли настольная версия?
Да, приложение для macOS, Windows и Linux скачивается с сайта проекта или со страницы релизов на GitHub. Оно само запускает локальные процессы, добавляет значок в трей и автозапуск. Установка из npm дает тот же CLI и веб-интерфейс.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПамять AI-агента хранит выводы и правила в Obsidian-совместимых Markdown-файлах, дает поиск и контроль записанных изменений.
Приложение в меню macOS пишет текст активных окон за день в markdown, а MCP-сервер отдает эту запись агенту
DocsMint дает агентам искать, читать и править документы базы знаний через 22 инструмента MCP, облако или свой Docker
MCP-сервер на Rust для папки с заметками в Markdown: агент ищет, читает заметки, видит обратные ссылки, теги, задачи и историю версий
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Roam Research MCP и CLI
Roam Research MCP and CLI
Агент ищет, читает и пишет в граф Roam Research через локальный API настольного приложения, есть CLI и скилл с синтаксисом
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MindOS — общая база знаний для людей и агентов (эта карточка) | нет | API-ключ | 704 | |
| Second Brain OS | нет | 1 476 | шаблон хранилища Obsidian со скиллами и командами для Claude Code | |
| Mnemon | нет | 695 | общая память агентов в виде локального графа знаний без заметок для людей |
Коротко о README
Сначала идет идея общей памяти человека и агентов и три тезиса: глобальная синхронизация контекста, прозрачность и обратная связь в виде инструкций. Раздел «Начало работы» ведет через установку, мастер, наполнение базы и подключение агента. Затем перечислены возможности для людей, агентов и инфраструктуры.