Le panneau
Sous l'icône, il ne contient que la série : le code, la question, l'explication. Une minute, et on retourne travailler.
Barre de menus · macOS · Open source
On délègue le code.Pas la compréhension.
Un utilitaire de barre de menus pour macOS. Trois questions rapides sur une fonction du projet en cours : vous répondez d'un clic, il vous explique pourquoi ce code est écrit comme ça.
Version v0.2.0 · 28 Mo · macOS 12 ou plus récent
Libre sous licence MIT, écrit par Yannis Nzue Essono
Publiée le 5 août 2026 · notes de version
composants/ListeFiltrable.tsx
TSXSérie du jour · 3 cartes
Une question arrive…
Pourquoi
Juste ou faux, l'explication vient toujours.
QCM
QCM
Vrai / faux
Série · 12 joursLe principe
Vous répondez court. L'application explique long.
Un projet grossit, on délègue une partie de son code, on relit le reste en diagonale. Quelques semaines plus tard, des pans entiers du dépôt ne sont plus que des noms de fichiers dont on devine la fonction.
Trois ou quatre questions, un geste chacune. Puis un texte qui dit pourquoi ce code est écrit comme ça.
« Le même “pourquoi” sur React, il y en a mille en ligne. Celui qui parle de votre ListeFiltrable, il n'y en a qu'un. »Les questions
Deux formes, un clic chacune
Rien à taper. La correction est locale : elle tombe à l'instant du clic, sans rien attendre du réseau.
QCM
Que fait cette ligne ? Quatre options, dont trois qu'on donnerait vraiment en lisant trop vite.
Vrai / faux
Une idée fausse répandue, tranchée en deux secondes.
Les deux surfaces
Un panneau pour répondre, une fenêtre pour prendre du recul
L'application n'apparaît pas dans le Dock, et rien ne s'ouvre au lancement : elle pose son icône dans la barre de menus, en haut à droite, et attend. Rien ne s'ouvre tout seul, jamais ; c'est vous qui décidez du moment.
La grande fenêtre
Au centre de l'écran, ce qu'on consulte en s'arrêtant : la progression et les réglages. Jours d'affilée, réussite par forme de question, notions qui résistent, répartition par langage.
Le rappel dans Claude Code
Là où le regard se pose déjà
Une notification suppose une autorisation du système et disparaît en trois secondes. Le compteur d'attente de Claude Code, lui, est déjà sous les yeux à chaque tour. C'est là que le rappel se glisse.
Terminal
Un interrupteur dans les réglages écrit un bloc spinnerVerbs dans ~/.claude/settings.json. L'éteindre rend à Claude Code ses propres verbes.
Pour écrire les vôtres, posez un tableau JSON dans ~/.knowyourcode/phrases.json — sans la balise, elle est ajoutée à la pose.
~/.knowyourcode/phrases.json
["Relis avant de valider", "Tu saurais réécrire ça sans moi ?"]Comment ça marche
Du projet en cours aux questions
Le projet en cours
Il se lit dans les transcripts JSONL de Claude Code, sous ~/.claude/projects/. Le transcript modifié en dernier désigne la session la plus récente, et son champ cwd donne le dossier de travail.
La sélection
Une fonction de 4 à 60 lignes, tirée au hasard — et non « la plus récente » : le code qu'on ne comprend plus n'est pas toujours celui qu'on vient d'écrire.
Les cartes
Le code part chez mistral-small-latest, qui en tire trois ou quatre questions, leurs réponses et leurs explications. Un modèle tiers plutôt que celui qui a écrit le code : on ne fait pas passer l'interrogation à qui a dicté la copie.
La correction, sur place
Tout arrive avant la première question : pendant la série, plus rien n'attend le réseau. Le reste vit en clair sur la machine, dans ~/.knowyourcode/, et rien n'en sort que la fonction tirée, le temps de fabriquer les cartes.
Installation
Trois étapes, dont une facultative
Glisser dans Applications
Ouvrez le DMG téléchargé et faites glisser
KnowYourCodedans le dossier Applications.Fournir une clé d'API Mistral
Les cartes sont fabriquées par l'API Mistral.
Variable d'environnementexport MISTRAL_API_KEY="votre-clé"Fichier dédiémkdir -p ~/.knowyourcode echo "votre-clé" > ~/.knowyourcode/cle_mistral chmod 600 ~/.knowyourcode/cle_mistralLa seconde ne dépend pas du terminal : c'est celle à préférer pour une application lancée depuis le Finder.
Ouvrir l'application
L'icône se pose dans la barre de menus, en haut à droite. Rien n'apparaît dans le Dock. Un clic ouvre le panneau, et vous réclamez une série quand vous le voulez.
Sans clé, l'application démarre quand même et pose des cartes factices : tout le reste fonctionne, il n'y a que les questions qui sont creuses. De quoi faire le tour de l'interface avant de décider.
L'installation depuis les sources est décrite dans le dépôt.
Trois questions quand vous avez une minute.
Version v0.2.0 · 28 Mo · macOS 12 ou plus récent