Aller au contenu
roomi fields

Outils pour travailler avec des agents IA

RTFM

Index local d'un projet (code, documents, PDF, notes) qu'un agent interroge avant de chercher dans les fichiers.

actif version v0.55.2, 29 octobre 2026 dernière modification 29 octobre 2026 licence MIT

Code source Site

RTFM est né pendant la rédaction d’un article de fiscalité française : sur un corpus d’environ 2 000 fichiers de textes réglementaires, Claude Code relançait les mêmes recherches, saturait son contexte et citait de travers. Sa limite principale : sur un petit dépôt, moins d’un millier de fichiers selon le README, la recherche ordinaire dans les fichiers suffit et l’index ajoute un coût sans gain.

Pas de démo jouable : l’outil tourne dans un terminal, à côté d’un agent.

Un catalogue, pas une mémoire

RTFM découpe chaque fichier selon sa structure : titres d’un Markdown, fonctions d’un Python, sections d’un LaTeX, pages d’un PDF. Il range ces morceaux dans un seul fichier SQLite, .rtfm/library.db. À une recherche, il répond par une liste courte : chemin, section, score. L’agent n’ouvre ensuite que ce qu’il choisit (rtfm_expand).

On peut y penser comme au catalogue d’une bibliothèque. Il ne lit pas à la place de l’agent ; il lui dit où regarder. La recherche est plein texte par défaut ; la recherche sémantique et le mode hybride sont en option, avec un modèle qui tourne en local sur le processeur. Rien ne quitte la machine.

Commencer

Dans Claude Code, par le catalogue de greffons roomi-fields/claude-plugins :

/plugin marketplace add roomi-fields/claude-plugins
/plugin install rtfm@roomi-fields

Le greffon indexe le projet au premier message, puis réindexe ce qui a changé à chaque message. Il ajoute au CLAUDE.md du projet la consigne de chercher dans l’index. Il suffit d’un Python 3.10 ou plus récent.

Pour un autre client (Cursor, Codex, Claude Desktop) ou en ligne de commande :

pip install rtfm-ai
cd mon-projet
rtfm init
rtfm search "authentication flow" --limit 3

Le client se branche ensuite sur rtfm-serve.

Ce qu’il fait

  • Lire 22 formats : Markdown, Python, LaTeX, PDF, EPUB, DOCX, ODT, CSV, XLSX, Jupyter, SQLite, XML de Légifrance, HTML du BOFiP, entre autres.
  • Accueillir un format de plus : une classe Python, d’une cinquantaine de lignes selon le README ; pour un JSON, un fichier de correspondance YAML suffit.
  • Relier les fichiers : liens wiki et imports Python deviennent un graphe (rtfm_graph).
  • Garder l’historique de chaque fichier indexé (rtfm_history).
  • Indexer les mémoires de Claude Code de tous les projets de la machine (rtfm memory).
  • Servir un coffre Obsidian : rtfm vault résout les liens et génère des pages de navigation dans _rtfm/.
  • Garder les réponses de NotebookLM écrites sur disque par notebooklm-mcp, pour les relire hors ligne.

L’agent dispose de 13 outils MCP ; la même chose existe en ligne de commande et en API Python.

Où il en est

Publié depuis février 2026 ; l’intégration continue passe.

Le README publie deux séries de mesures, sur une tâche documentaire et sur FeatureBench, avec leurs réserves : un seul modèle, un seul agent. Je ne reprends pas leurs chiffres ici tant que le nombre d’exécutions par configuration n’est pas publié. Des bancs d’essai mieux adaptés à la recherche d’information (RepoQA, SWE-QA, LocAgent) sont prévus, sans date. Les nouveautés sont dans le journal des versions du dépôt.

Dépôt · Documentation · RTFM · NotebookLM

Merci à @AVeryTastyRaspberry, qui a rendu RTFM utilisable sous Windows : le signalement (#8) nommait la ligne fautive, et les essais sur une vraie machine Windows 11 ont trouvé cinq défauts de plus.

Fabrication. Claude Code (Claude Opus 5.5), à partir du dépôt, de son README et de ses notes de version. Méthode

Tickets ouverts