Barre de menus · macOS · Open source

On délègue le code.Pas la compréhension.

Name: KnowYourCode
Availability: InStock
Author: Yannis Nzue Essono

Un utilitaire de barre de menus pour macOS. Il tire au hasard une fonction du projet en cours, vous demande de l'expliquer, et vous dit ce que vous avez oublié.

Télécharger pour macOS Voir sur GitHub

Version v0.1.0 · 28 Mo · macOS 12 ou plus récent

Libre sous licence MIT, écrit par Yannis Nzue Essono

Publiée le 4 août 2026 · notes de version

connais_ton_code/selection.py

Python

def fonctions_du_fichier(chemin):
    """Les fonctions du fichier."""
    source = chemin.read_text()
    try:
        arbre = ast.parse(source)
    except SyntaxError:
        return []

    retenues = []
    for noeud in ast.walk(arbre):
        if not est_fonction(noeud):
            continue
        taille = longueur(noeud)
        if MIN <= taille <= MAX:
            retenues.append(noeud.name)
    return retenues

Votre explication

Expliquez ce que fait cette fonction…

⌘ ⏎ RépondrePasser

Le mécanisme est juste, la sélection aussi.

Ce que vous n'avez pas dit

Les bornes MIN et MAX sont inclusives.
ast.walk descend dans tout l'arbre : les fonctions imbriquées comptent.
La lecture est hors du try — un fichier illisible remonte l'erreur.

Sélection

Explication

Évaluation

Verdict

Le principe

Garder la maîtrise d'un code qu'on ne relit plus

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.

Le but n'est pas de noter, mais de remettre une fonction sous les yeux, à froid.

« Rien ne s'ouvre tout seul, jamais. C'est vous qui décidez du moment. »

Pas de notification, pas de fenêtre qui surgit au milieu d'une phrase. L'icône attend ; vous cliquez quand vous avez deux minutes.

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.

Le panneau

Sous l'icône, il ne contient que l'exercice : le code, une zone de saisie, le verdict. On y répond en trente secondes et on retourne travailler.

La grande fenêtre

Au centre de l'écran, ce qu'on consulte en s'arrêtant : la progression et les réglages. Scores, courbe des vingt derniers, oublis récurrents, 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 au verdict

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.

L'évaluation

Le code et votre explication partent chez mistral-small-latest. Un modèle tiers plutôt que celui qui a écrit le code : on ne demande pas à quelqu'un de corriger la copie qu'il a dictée.

Les données locales

Tout reste sur la machine, en clair, dans ~/.knowyourcode/. Rien d'autre n'en sort que la fonction tirée et votre explication, le temps de l'évaluation.

Installation

Trois étapes, dont une facultative

Glisser dans Applications
Ouvrez le DMG téléchargé et faites glisser KnowYourCode dans le dossier Applications.
2
Fournir une clé d'API Mistral
L'évaluation passe par l'API Mistral.
Variable d'environnement
$export MISTRAL_API_KEY="votre-clé"
Fichier dédié
$mkdir -p ~/.knowyourcode $echo "votre-clé" > ~/.knowyourcode/cle_mistral $chmod 600 ~/.knowyourcode/cle_mistral
La 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 question quand vous le voulez.

Sans clé, l'application démarre quand même et rend une évaluation factice : tout le reste fonctionne, il n'y a que le verdict qui est faux. 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.

Prenez une question quand vous avez deux minutes.

Version v0.1.0 · 28 Mo · macOS 12 ou plus récent

Télécharger pour macOS