edda

Edda — это инструмент командной строки для создания и публикации сайтов документации, написанных на MDX, позиционируемый как «документация знаний для агентов» с git-нативным рабочим процессом, который публикует изменения при слиянии. В README он представлен как тот же подход, используемый для каждого сайта документации на его платформе, включая captain.blode.md. Установка выполняется глобально через npm: `npm install -g edda-docs`. Быстрый старт: `edda login` для аутентификации через GitHub в браузере (без необходимости вручную управлять API-ключом), `edda new docs --template starter` для создания каркаса сайта документации в каталоге, `edda dev` для локального запуска на localhost:3030 с перезагрузкой при редактировании и `edda push docs` для развёртывания. Развёрнутый сайт становится доступен на собственном поддомене blode.md, а имя, навигация и тема берутся из файла docs.json, который создаёт `edda new`. Набор команд охватывает аутентификацию (`login`), создание каркаса (`new`, с шаблонами `minimal` или `starter`), локальный предпросмотр (`dev`), проверку конфигурации (`validate`), развёртывание (`push`), список аккаунтов (`projects`) и управление аналитикой PostHog (`analytics` с `get`, `set posthog <key>`, `unset posthog`). Для использования агентами в README описан устанавливаемый slash-command для Claude Code или любого агента, совместимого с skills.sh, через `npx skills add mblode/edda -g --all -y`, после чего создание каркаса и развёртывание можно выполнять обычным языком, например `/edda new my-project --template starter` и `/edda push docs/ --project my-project`. Поддержка CI и автоматизации — заметный акцент. Переменные окружения включают EDDA_API_KEY / BLODEMD_API_KEY (используются раньше сохранённой сессии входа, чтобы CI не требовал интерактивного входа), EDDA_PROJECT / BLODEMD_PROJECT как значение по умолчанию для `--project` и EDDA_API_URL / BLODEMD_API_URL для источника API. Коды выхода описаны как стабильные и пригодные для ветвления: 0 — успех, 1 — ошибка, 2 — отменено (включая отклонённый запрос), 3 — неверный ввод или конфигурация, 4 — требуется аутентификация, 5 — сбой сети. При `--json` сбои выводятся одной строкой в stdout вида `{"error":true,"code":"AUTH_REQUIRED","message":"...","hint":"..."}`, и README советует ветвиться по стабильному полю `code`, а не по ориентированному на человека `message`. Дополнительные примечания указывают, что требуется Node.js 24, что `push`, `validate` и `projects` принимают `--json`, что `push` читает значения проекта, API-ключа и ветки из окружения для неинтерактивного развёртывания в CI и что установка GitHub App из панели проекта включает автоматическое развёртывание при каждом push в ветку. Проект распространяется по лицензии MIT, автор — Matthew Blode.