ИИ пишет Markdown
Агенты читают и правят обычные .md нативно. Файлы в репозитории - то место, где они сильнее всего, и где инженеры и так смотрят изменения.
WYSIWYG-редактор Markdown.
Для документации в git-репозитории.
Docs as code, но работать может не только инженер. Как Google Docs, только файлы никуда не уезжают: комментарии к абзацам, ответы, история и дерево документов, которое откроет не инженер.
Бесплатно и останется бесплатным. Без аккаунта и без сервера. macOS и Windows. Интерфейс приложения на английском - русской локализации пока нет.
Документация уже переехала.
Инструменты - нет.
Поэтому документы уехали туда же
Спеки, PRD, RFC и рунбуки ушли из вики и легли рядом с кодом. Это было правильно, и обратно их никто не понесёт.
А все остальные остались без инструментов
Ни комментариев, ни тредов, ни дерева документов, ни способа поправить абзац, не разобравшись сначала в редакторе кода, диффе и ребейзе.
Всё, чем вы пользуетесь в Google Docs,
на файлах, которые не покидают репозиторий.
| Что нужно | Google Docs | Markdown в редакторе кода | Notula |
|---|---|---|---|
| Комментарий к абзацу, ответ, закрытие треда | — | ||
| Узнать, что вас упомянули или что-то прокомментировали | — | ||
| Видно, кто менял документ с тех пор, как вы его открыли | — | ||
| Писать, не видя разметки | — | ||
| Дерево документов вместо списка файлов | — | ||
| Назад и вперёд между связанными документами | — | ||
| Откроет человек, который никогда не открывал терминал | — | ||
| Файлы остаются обычными .md в вашем репозитории | — | ||
| ИИ-агенты читают и правят те же самые файлы | — | ||
| Ревью обычным пулл-реквестом | — | ||
| Работает без сети и без аккаунта у вендора | — | ||
| Рассказывает вашему ИИ-агенту, как устроен воркспейс | — | — |
Комментарии, ради которых документ вообще открывают
Выделите фрагмент, оставьте комментарий, ответьте, закройте тред. Треды коммитятся рядом с документом: приезжают с клоном и переживают любой аккаунт. Сами документы остаются чистыми - без якорей и скрытых идентификаторов внутри.
Разметки не видно. Вообще
WYSIWYG, а не превью сбоку. Ни решёток, ни звёздочек, ни палок от таблицы - включая строку, на которой стоит курсор. На диске остаётся обычный Markdown.
Правка в один символ остаётся диффом в один символ
Notula записывает обратно только то, что изменилось. Открыть файл и сохранить, не тронув, - байты те же. На 6000 реальных документов 96,4% блоков переживают правку нетронутыми, поэтому пулл-реквест остаётся читаемым.
Только документация, без кода
Откройте репозиторий с тысячами исходников и получите чистое дерево Markdown. Список файлов Notula спрашивает у git, поэтому .gitignore соблюдается сам собой, а папки без документов не появляются.
Git, не обучая гиту
Каждая версия документа доступна для чтения и возврата. Никому не показывают ребейз, стеш и слова detached HEAD. Публикация - одно предложение о том, что изменилось.
Агент получает бриф, а не догадку
Notula записывает, как устроен воркспейс, и показывает это Claude Code.
-
Она пишет
notula-agents.md: типы документов, их поля, раскладка по папкам и принятые соглашения. Обычный файл, который коммитится и приезжает с клоном, поэтому у всех агентов в команде бриф один. -
На него ставится ссылка из файла самого ассистента.
В
CLAUDE.mdуходит@-импорт в три строки. Codex, Cursor и Copilot читаютAGENTS.md, где импорта нет, поэтому туда правила пишутся прямо. Notula владеет одним блоком между маркерами и не трогает ничего вокруг. -
Что умеет окно, то умеет команда:
notula info- что это за воркспейс,notula mentions ai- комментарии, адресованные ассистенту,notula status- что здесь написано, но ещё никем не увидено.
Подробно - на странице про агентов (по-английски).
Рассчитана на репозиторий, в котором работают другие
Notula - гость в чужом воркспейсе и ведёт себя как гость.
Только свои файлы
У каждой команды git явный pathspec. Notula никогда не добавляет в индекс весь воркспейс.
Чужая работа не тронута
Откройте репозиторий, в котором лежат чужие незакоммиченные правки. Notula не делает stash и не переписывает историю.
Ни веток, ни пулл-реквестов
Коммит уходит в ту ветку, на которой вы стоите. Notula не создаёт и не переключает ветки, а если ветка защищена, скажет об этом до того, как вы начнёте править.
Документы никуда не уходят
Сервера Notula не существует, аккаунта тоже. Документы, комментарии и история лежат файлами в репозитории, а наружу приложение ходит только в ваш git-remote и на страницу релизов, откуда обновляет себя.
Где проект на самом деле
Раннее, но рабочее. Честное состояние на сегодня.
- Письмо: WYSIWYG без разметки на экране, таблицы, диаграммы, картинки, сноски, код
- Round trip: побайтово на 6000 реальных документов, 96,4% блоков переживают правку нетронутыми
- Воркспейс: дерево, быстрое открытие, полнотекстовый поиск, сплиты, назад и вперёд, история
- Комментарии: треды, ответы, упоминания, предложенные правки, инбокс ревью, уведомления
- Git: фоновый fetch, публикация одним предложением, конфликт как выбор между двумя абзацами
- macOS: Apple Silicon и Intel, обновляется сама. Подписи пока нет - первый запуск через одну команду
- Windows: установщик x64 и arm64, обновляется сам. Подписи пока нет - SmartScreen спросит один раз
- Linux: не собирается
Что спрашивают до того,
как навести это на рабочий репозиторий.
На каком языке интерфейс?
На английском. Локализации пока нет, и это единственное место, где русская страница расходится с продуктом. Документы, комментарии и имена файлов - на любом языке, поиск по русскому тексту работает.
Это меняет мой репозиторий?
Только те файлы, которые вы правите, и лог комментариев рядом с ними. У каждой команды git явный pathspec: Notula не добавляет в индекс весь воркспейс, не делает stash, не переписывает историю и не создаёт и не переключает ветки.
Нужно ли знать git?
Нет. Вы открываете папку, пишете и публикуете одним предложением о том, что изменилось. Ребейз, стеш и маркеры конфликта не показывают никому. Если двое правили один абзац, вы выбираете между двумя версиями, а не разбираете конфликт руками.
Работает с приватными репозиториями?
Да. Notula управляет тем git, который уже установлен на вашей машине, поэтому используется ваш SSH-ключ или credential helper. Приложение не спрашивает пароль и не хранит своих токенов.
Где лежат комментарии?
В репозитории рядом с документом, обычным файлом: append-only лог с union merge driver. Они приезжают с клоном, а документы остаются чистыми.
Не станет ли медленно на большом репозитории?
Нет. Список файлов Notula берёт у git, а не обходит диск, и оставляет только Markdown. Репозиторий с тысячами исходников открывается деревом документов за секунду.
Это бесплатно?
Да, и останется бесплатным. Ни аккаунта, ни сервера, ни платы за место. Если что-то платное появится, это будет сервис с сервером - например, публикация документа на общедоступную страницу. Приложение на вашей машине - не оно.
Можно ли продолжать работать в этом же репозитории через Claude Code?
Ради этого всё и делалось. Notula пишет бриф о воркспейсе и подключает его к вашему CLAUDE.md, поэтому агент знает принятые у вас соглашения. Когда он перепишет документ, который у вас открыт, правка приедет к вам на глаза.
Исходники открыты?
Нет. Notula - студия поверх того, что у вас уже есть: ваш Markdown, ваш репозиторий, ваш git. Своего она не держит ничего. Лог комментариев - обычный файл рядом с документами, схема воркспейса опубликована, а команда notula умеет всё то же, что окно. Удалите приложение - документы и комментарии останутся и будут читаться без него.
Откройте на репозитории, который у вас уже есть
Бесплатно, без аккаунта и без сервера. Документы в нём станут деревом примерно за секунду.
Apple Silicon. Есть для Intel и для Windows. 64 бита. Есть для Windows на Arm и для macOS.
Ни одна из сборок пока не подписана, поэтому первый запуск требует одного лишнего шага. Окно скачивания проведёт по нему.
Если macOS пишет, что Notula повреждён (страница по-английски)