edda

Edda est un outil en ligne de commande pour créer et publier des sites de documentation écrits en MDX, positionné comme des « knowledge docs for agents » avec un workflow natif de git qui publie lors du merge. Le README le présente comme la même approche utilisée pour chaque site de docs sur sa plateforme, y compris captain.blode.md. L'installation est globale via npm : `npm install -g edda-docs`. Le parcours de démarrage rapide est : `edda login` pour s'authentifier avec GitHub dans le navigateur (aucune clé API à gérer manuellement), `edda new docs --template starter` pour générer la structure d'un site de docs dans un répertoire, `edda dev` pour le servir localement sur localhost:3030 avec rechargement à l'édition, et `edda push docs` pour déployer. Un site déployé est mis en ligne sur son propre sous-domaine blode.md, avec le nom, la navigation et le thème tirés du fichier docs.json que `edda new` génère. L'ensemble des commandes couvre l'authentification (`login`), la génération de structure (`new`, avec les templates `minimal` ou `starter`), la prévisualisation locale (`dev`), la vérification de la configuration (`validate`), le déploiement (`push`), la liste des comptes (`projects`) et la gestion des analytics PostHog (`analytics` avec `get`, `set posthog <key>`, `unset posthog`). Pour l'usage par des agents, le README documente une slash command installable pour Claude Code ou tout agent compatible skills.sh via `npx skills add mblode/edda -g --all -y`, après quoi la génération de structure et le déploiement peuvent être pilotés en langage naturel, par exemple `/edda new my-project --template starter` et `/edda push docs/ --project my-project`. La prise en charge de la CI et de l'automatisation est un point notable. Les variables d'environnement incluent EDDA_API_KEY / BLODEMD_API_KEY (utilisées avant une session de connexion stockée afin que la CI n'ait pas besoin de connexion interactive), EDDA_PROJECT / BLODEMD_PROJECT comme valeur par défaut pour `--project`, et EDDA_API_URL / BLODEMD_API_URL pour l'origine de l'API. Les codes de sortie sont documentés comme stables et exploitables dans des branchements : 0 succès, 1 erreur, 2 annulé (y compris une invite refusée), 3 entrée ou configuration invalide, 4 authentification requise, 5 échec réseau. Avec `--json`, les échecs sont émis sur une seule ligne stdout de la forme `{"error":true,"code":"AUTH_REQUIRED","message":"...","hint":"..."}`, et le README conseille de brancher sur le champ stable `code` plutôt que sur le `message` orienté humain. Des notes supplémentaires indiquent que Node.js 24 est requis, que `push`, `validate` et `projects` acceptent `--json`, que `push` lit les valeurs de projet, de clé API et de branche depuis l'environnement pour un déploiement CI non interactif, et que l'installation de la GitHub App depuis un tableau de bord de projet permet le déploiement automatique à chaque push vers une branche. Le projet est sous licence MIT et créé par Matthew Blode.