Aller au contenu
Ailleaume Labs
← Tous les projets

N°03 · Outil open source · Claude Code

Nakiros

La salle de contrôle locale de votre dossier .claude.

Un outil open source, sous licence MIT, qui tourne sur votre machine. Nakiros répertorie chaque skill, agent, règle, hook et réglage que Claude Code utilise, les vérifie d’après la documentation officielle et propose des corrections, que vous validez.

Il analyse aussi les conversations passées, pour repérer les moments où l’agent et vous ne vous êtes pas compris.

Essayer sur nakiros.com (nouvel onglet)
La vue de Nakiros qui liste les skills, agents et règles du dossier .claude, avec leur score et leur conformité.

Défis techniques

  1. 01

    Analyser des conversations sans exploser le coût

    Une session de 30 échanges pèse environ 80 000 tokens. Nakiros en fait d'abord un résumé : le texte est gardé, mais chaque appel d'outil tient en une ligne. On descend à 3 000 à 5 000 tokens, qu'un petit modèle (Claude Haiku) classe en phases, frictions et règles à proposer. L'analyse se lance seule à la fin de chaque session, grâce à un hook que Nakiros installe sans toucher au reste de la configuration.

  2. 02

    Repérer les frictions sans IA

    Regrouper une même friction d'une conversation à l'autre, ou voir qu'une session a dérivé de son sujet, doit marcher hors ligne et dans toutes les langues. Le regroupement repose sur une mesure de similarité (Jaccard), avec un bonus quand des fichiers sont en commun. La dérive est détectée par un ancrage lexical, sans dictionnaire ni modèle. Pour Codex, le score s'appuie sur des signaux de structure plutôt que sur des phrases, et il est testé sur du chinois.

  3. 03

    Tester un skill sans que la copie installée fausse le résultat

    Si le skill évalué est aussi installé sur la machine, Claude utilise l'ancienne copie, et une correction semble n'avoir aucun effet. Chaque évaluation tourne donc dans un dossier personnel isolé, recréé par liens symboliques, sans ce qui ajoute du contexte. Un second modèle note ensuite les réponses, pour qu'un agent ne se juge pas lui-même.

Technologies
  • TypeScript
  • Node.js
  • Fastify
  • React 19
  • Vite
  • Tailwind CSS
  • Claude Code
  • Codex
Fait par
Thomas Ailleaume