PIMacs : une couche Doom Emacs modulaire, documentée et reproductible

This article is available in English.

PIMacs n’est pas « une énième configuration Emacs ».
Il s’agit d’une couche modulaire, documentée et reproductible au-dessus de Doom Emacs, conçue pour fournir un écosystème de développement prêt à l’emploi comparable aux IDE modernes — tout en préservant la flexibilité d’Emacs.

PIMacs repose sur quatre idées fondamentales :

• Des modules composables plutôt qu’une configuration monolithique
• Des workflows auto-documentés via des refcards générées automatiquement
• L’installation à la demande des outils de développement via Mise
• Des environnements portables et reproductibles, incluant Docker avec support X

Tout le reste est optionnel.

Philosophie : Emacs comme un système, pas comme un simple dotfile

La plupart des configurations Emacs deviennent progressivement des dotfiles personnels non structurés.
PIMacs considère Emacs comme un système :

• Les modules sont explicites
• Les outils sont déclaratifs
• La documentation est générée
• Les environnements sont reproductibles

Le résultat est un éditeur qui se comporte davantage comme les IDE Zed ou JetBrains : on ouvre un projet → les outils sont disponibles → on commence à travailler.

Mais sans renoncer au contrôle.

Conçu de manière modulaire

PIMacs est organisé comme un ensemble de modules indépendants compatibles avec Doom :

modules/pimacs/
├── default/
├── keys/
├── avy/
├── session/
├── ui/
├── lang-go/
├── lang-php/
├── lang-c/
├── docker/
├── refcards/
└── …

Chaque module a un périmètre clair, peut être activé ou désactivé indépendamment, et déclare à la fois le comportement de l’éditeur et les exigences en matière d’outillage grâce à Mise.

Vous pouvez tout activer :

(load! "modules/pimacs/init")

Ou composer volontairement votre configuration :

(load! "modules/pimacs/default")
(load! "modules/pimacs/lang-go")
(load! "modules/pimacs/refcards")

Rien n’est implicite. Si c’est actif, c’est parce que vous l’avez choisi.

Outils à la demande avec Mise : un niveau de préparation équivalent à un IDE

L’une des fonctionnalités les plus puissantes de PIMacs est son intégration étroite avec Mise pour la gestion des outils de développement. Plutôt que de supposer que les outils sont déjà installés sur le système, PIMacs peut installer automatiquement et gérer les chaînes d’outils à la demande, module par module.

Chaînes d’outils déclaratives par langage

Chaque module de langage peut fournir son propre fichier mise.toml déclarant les outils requis. Par exemple, le module Go définit sa chaîne d’outils ici. Cela peut inclure :

• Go lui-même
• Des serveurs de langage
• Des formateurs de code
• Des linters
• Des outils CLI auxiliaires

Lorsque vous chargez le module lang-go avec l’option +tool, l’outillage requis est :

• détecté
• installé automatiquement s’il est manquant
• activé automatiquement pour l’utilisateur courant

Comme Mise installe des outils par utilisateur, versionnés et gérés, et non de manière globale au système, Emacs est immédiatement utilisable, avec tous les outils requis disponibles sans configuration manuelle. Contrairement à la plupart des configurations Emacs, PIMacs considère l’outillage externe comme faisant partie du contrat de l’éditeur, et non comme un prérequis.

Intégration CLI au sein d’Emacs

La CLI PIMacs intègre directement Mise dans les workflows Emacs :

• Garantit que les bonnes versions des outils sont disponibles
• Aligne l’outillage Emacs avec les attentes du projet
• Maintient la synchronisation entre la CLI et l’éditeur

Du point de vue de l’utilisateur, l’expérience est similaire à celle des IDE modernes comme Zed : cloner → ouvrir → coder.

La différence est que l’outillage reste :

• explicite
• reproductible
• transparent

Refcards auto-générées : une documentation qui ne ment pas

PIMacs inclut un système de refcards qui génère automatiquement la documentation à partir de la configuration active. Il fournit également des refcards par module, extraites directement du code lui-même. Par exemple :

• Raccourcis clavier par défaut de PIMacs/keys avec l’option de clavier « azerty »
• Raccourcis clavier de PIMacs/lang-go avec l’option de clavier « azerty ».
• Raccourcis clavier de PIMacs/lang-php avec l’option de clavier « azerty ».
• etc…

En pratique, chaque module qui définit des raccourcis clavier fournit également ses propres refcards détaillées.

Au lieu de documents écrits à la main qui dérivent avec le temps, PIMacs extrait les raccourcis et les commandes depuis les modules, génère des refcards structurées et maintient la documentation alignée avec la réalité. Cela rend la configuration auto-explicative, auditable et partageable.

La documentation devient un artefact de construction, pas une réflexion après coup.

Des keymaps qui respectent votre clavier

La navigation et l’ergonomie sont des préoccupations de premier ordre.

Les modules pimacs/keys et pimacs/avy définissent une couche de navigation cohérente. Pour les utilisateurs de claviers AZERTY, un sélecteur explicite existe :

(keys +azerty)

La disposition du clavier fait partie de l’environnement — PIMacs la traite comme telle.

Emacs dans Docker, avec support X

PIMacs peut fonctionner de manière entièrement opérationnelle à l’intérieur de conteneurs Docker avec support graphique complet.

Cela permet :

• des configurations identiques sur plusieurs machines
• des expérimentations isolées
• des démonstrations reproductibles
• des environnements CI maîtrisés

Avec le forwarding X, vous obtenez un véritable Emacs graphique avec thèmes, polices, Tree-sitter, le tout entièrement encapsulé.

Support des langages sans excès

Les modules de langage (lang-*) suivent une règle unique :

Activer l’outillage moderne à la demande et rester prévisible.

• Tree-sitter lorsqu’il est pertinent
• LSP sans magie
• Des valeurs par défaut minimales, faciles à surcharger

PIMacs évite les couches d’abstraction lourdes et respecte le contrôle de l’utilisateur.

Conclusion

PIMacs répond à une question pratique :

Emacs peut-il offrir une expérience de niveau IDE sans devenir opaque ?

La réponse est oui, si :

• la configuration est modulaire
• l’outillage est déclaratif
• la documentation est générée
• les environnements sont reproductibles

PIMacs fournit un écosystème de développement prêt à l’emploi comparable à Zed ou à JetBrains — tout en restant indéniablement Emacs.

Dépôt : https://github.com/pivaldi/pimacs

Emacs est une plateforme. PIMacs la traite comme telle.