dmthepm/commune-wiki

Commune-wiki — это движок персональной вики для Astro, который собирает связанный сайт из папки markdown-заметок. Он нужен тем, кто ведёт личную базу знаний и хочет видеть связи между заметками прямо во время письма.

Ключевые возможности

• Связанные заметки открываются в скользящих панелях рядом друг с другом
• На каждой странице есть список обратных ссылок и markdown-двойник по тому же адресу
• CLI запрашивает граф ссылок прямо во время написания заметок
• Опциональные агентские навыки превращают надиктованный черновик в версию для проверки
• Стартовый проект создаёт вики одной командой и проверяет пример контента
• Работает как интеграция в существующем проекте Astro 7

Для каких задач подходит

• Ведение личной базы знаний с наглядными связями между заметками
• Публикация заметок в открытый доступ по мере их развития
• Черновики из надиктованных мыслей с последующей ручной проверкой
• Поиск связей между заметками через CLI во время письма
• Перенос существующих markdown-заметок в связанную вики на Astro

Подробнее

Commune — это движок для персональной вики, построенный вокруг папки markdown-файлов. Каждая заметка получает страницу на Astro, а связи между заметками образуют граф: на странице видны обратные ссылки, а сама заметка открывается в панели рядом с той, из которой вы пришли. У каждой страницы есть markdown-двойник по тому же адресу с расширением .md, что упрощает доступ к исходному тексту. CLI работает с графом ссылок во время написания, помогая находить связи, а опциональные агентские навыки превращают надиктованный черновик в версию, которую вы просматриваете и правите вручную.

Запуск начинается с клонирования репозитория и скрипта create-wiki, который создаёт отдельный проект вики. Для работы нужен Node 22.12 или новее, npm и Git; версия Node 22.19 или новее избегает предупреждения EBADENGINE от зависимости Astro. Скрипт не устанавливает зависимости — npm install выполняется уже в новой вики, а сам репозиторий движка установки не требует. Существующий проект Astro 7 может пропустить стартовый набор и использовать интеграцию. Агентские навыки устанавливаются отдельно в уже существующую вики и не создают сайт.

Стоит учитывать, что стартовый набор — это отдельный проект поверх опубликованного пакета, а не сам репозиторий. Команды создания отказываются перезаписывать папку, поэтому для повторного запуска нужно удалить commune-wiki и my-wiki. При запуске кодинг-агентом на macOS или Linux Astro 7 поднимает dev-сервер в фоне и печатает адрес в JSON; остановить его можно командой npx astro dev stop. Проект распространяется под лицензией MIT.