Главная / mdhouse

Заметки и документация в одной вкладке браузера. AI пишет вопросы — вы отвечаете в один клик.

Укажите папку — с заметками, репозиторий, целый каталог репозиториев — и получите одну быструю страницу с деревом файлов, мгновенным поиском и живой лентой «что изменилось недавно» на основе git. Ничего не импортируется, не индексируется и никуда не загружается, а в папку mdhouse пишет, только если вы это разрешили.

GitHub npm changelog AI-разметка

mdhouse в браузере: слева дерево файлов с отметками свежести, в центре отрендеренный
документ с оглавлением, справа недавняя git-история файла.

▸ Установка

bun install -g mdhouse      #  bun 1.4+ required

▸ Запуск

mdhouse ~/notes ~/src -p     # serve folders, -p = save them for every later start, start in background
mdhouse service install      # starts now and at every login, serving the saved folders

Откройте http://127.0.0.1:7777
mdhouse --rw <folder> — добавить новую папку и разрешить редактирование и ответы прямо на странице
Подробнее — в разделе Running it

📖 Читалка для всего, что вы пишете

⚡ Живые обновления, без опроса: Файл меняется на диске — страница тут же меняется через WebSocket. Правьте в своём редакторе или отдайте правку агенту и просто смотрите.
🔥 ♨️ Свежесть видна сразу: 🔥 — изменено за последние десять минут, ♨️ — за последний час, а дальше за неделю цвет выцветает до серого. Новое сразу бросается в глаза.
🌿 Встроенный git: Кто, что и когда менял, что нового со вчерашнего дня, последние коммиты каждого файла. Commit, pull и push — одной кнопкой.
⊟ Понятные диффы: Изменения показаны прямо поверх отрендеренного документа — добавленное зелёным, удалённое красным — и читаются так же легко, как сам документ.
🖋 Рендерит как надо: GitHub-flavored Markdown плюс алерты, сноски, диаграммы mermaid, подсветка кода, front matter; картинки, PDF и видео прямо в тексте. Как на GitHub, а то и лучше.
📁 Все папки в одном дереве: Все репозитории в одной боковой панели; .gitignore учитывается, у каждого файла свой URL.
🔍 Найдётся всё: Имена файлов ищутся прямо по мере набора, полный текст — через ripgrep; найденное открывается ровно на нужной строке.
🕐 Recent и Mine: Что недавно менялось во всех папках и что поменяли вы — незакоммиченное сверху.

Вкладка Recent: по строке на файл с папкой и заголовком коммита, ромбик у ваших
собственных файлов, возраст каждого раскрашен по свежести.

👾 Рабочее место для вас и вашего AI

Агент пишет в обычный файл .md, а mdhouse превращает его разметку в кнопки. Файл и есть диалог: никакой истории чата, которую можно потерять, и на GitHub он по-прежнему нормально читается.

❓ AI спрашивает — вы кликаете: Его вопросы превращаются в кнопки. Напишите ответ — он попадёт обратно в файл, AI прочитает его и продолжит работу.
💡 AI предлагает — вы решаете: ✓ согласиться или ✗ отменить — в один клик. Варианты превращаются в радиокнопки.
🔴 🟠 ⚪ Проблемы по полочкам: AI находит проблемы и помечает, насколько серьёзна каждая; отдельная полоска считает их и фильтрует. Что чинить — решаете вы.
🎯 Укажите, что делать: Отметьте пункты, которые нужно сделать следующими, — AI возьмётся только за них.
✅ Сделанное на виду: Исправленные пункты зеленеют и сворачиваются, а рядом с ними — коммит.
📌 Решения не пересматриваются: Принятые правила выделены, а под ними — отвергнутые альтернативы, чтобы никто, ни человек, ни AI, не затевал спор заново.

Открытые вопросы в mdhouse: один уже отвечен и свёрнут, у другого предложение AI и кнопки
согласия, отмены и ответа, у третьего два варианта, у четвёртого открыта форма ответа. — Вопросы агента и ответы на них прямо на странице.

Работает с любым AI

agent-markup.md написан для AI-агентов, а не для людей: одна самодостаточная страница, которая учит агента разметке, рекомендуемой mdhouse, — вопросам, предложениям, вариантам, проблемам с уровнем серьёзности, решениям и id, — чтобы всё, что он пишет, на странице превращалось в кнопки, а на GitHub читалось как обычный Markdown. Дайте любому агенту ссылку и скажите «делай так»:

use https://github.com/parf/mdhouse/blob/main/doc/agent-markup.md and do a review

Для Claude Code есть готовые скиллы — /ask-questions, /resolve-questions, /find-issues, /fix-issues: просто попросите его скопировать их из репозитория. Руководство для людей — Вопросы и ответы.

🗨 Чат с агентом о странице

Если запущен agent-bus, mdhouse открывает рядом с документом панель чата. Вы обсуждаете с AI-агентом открытую страницу; он читает тот же файл, а у каждой страницы своя история.

mdhouse with the Agent Bus panel on the right: requests sent to a Claude Code session,
its answers, a note box and the Updated, Send note, Do, Resolve and Review buttons.

Работа идёт в самом документе — чат лишь направляет на него агента. Агент правит файл, страница обновляется на лету, вы отвечаете прямо на ней, а кнопка «Updated» возвращает ход агенту.
Обычный следующий шаг — в один клик: перечитать, сделать пункты 🎯, перенести ответы, провести ревью.
У страницы может быть свой агент — он записывает в файл своё имя на шине; иначе агента выбираете вы или отвечает агент по умолчанию.
Агенту ничего дорабатывать не нужно — это обычное сообщение agent-bus, и он отвечает на него, как любому другому участнику.

mdhouse --agent-bus                        # local bus
mdhouse --agent-bus http://host:6767       # remote bus, over TCP with a token

Подробности, включая вариант с сокетом, проброшенным через ssh, без токена: интеграция с Agent Bus.

🔒 Локально и безопасно

По умолчанию только чтение — пишет только в папки, открытые с --rw.
Маленькие проверяемые правки — галочка, ответ, блок под заголовком. Каждая трогает только свои строки; если файл тем временем изменился, запись отклоняется, а ваш текст сохраняется.
Всё остаётся на вашей машине — слушает 127.0.0.1, если не указать --host; ничего не копируется и никуда не загружается (доступ).
Светлая и тёмная тема, в том числе на телефоне.

Лицензия

GPL-2.0.