Penmentor: Een AI-mentor die jouw wiskunde leest

De workflow: Handgeschreven tekst in xournal++ → één toets → de fout wordt op de pagina gemarkeerd → omkader de integraal → een interactieve manim-animatie.

Waarom ik dit gebruik

Ik studeer calculus met een pen-tablet in xournal++. Voorheen maakte ik voortdurend screenshots van mijn werk om deze naar Claude te sturen, waarna ik lange antwoorden moest teruglezen. Wat ik echter echt wilde, was een docent die over mijn schouder meekijkt: iemand die de fout omcirkelt, vinkjes zet bij wat correct is, me een zetje geeft in de juiste richting naar de volgende stap en uitlegt waarom. Penmentor realiseert dit, slechts één toets verwijderd, via mijn eigen Claude-abonnement.

Hoe het helpt bij het leren

• Hints, geen antwoorden: Er is een ladder van ondersteuning, variërend van een klein zetje tot het benoemen van de techniek of een vage schets van de volgende regel. Jij doet het denkwerk, en dat is precies wat ervoor zorgt dat de stof beklijft.
• Feedback op je eigen werk: De eerste echte fout wordt omcirkeld op de plek waar deze is gemaakt. Correcte regels krijgen een vinkje en latere regels die de fout overnemen, worden onderstreept. De markeringen blijven zichtbaar terwijl je verder schrijft; met de Esc-toets kunnen ze worden gewist.
• Oefeningen die herinnering stimuleren: De tool stelt vragen over je belangrijkste stappen (die je kunt beantwoorden door te typen of te schrijven), biedt oefeningen om fouten te vinden en vraagt "welke techniek past hier?".
• Visualisatie: Omkader het deel dat je wilt begrijpen en krijg een interactieve animatie gemaakt met manim (de tool van 3Blue1Brown). Je kunt grenzen verslepen, waarden opnieuw invoeren en zien hoe bijvoorbeeld Riemann-sommen zich sluiten.
• Bewust van de hele pagina: Dankzij een kleine xournal++ plugin heeft de AI toegang tot de volledige pagina, en niet alleen tot het gedeelte dat op dat moment op het scherm zichtbaar is.

Compatibiliteit met Claude Code, Codex en Antigravity

Penmentor draait op de AI-command-line agent die je al gebruikt, binnen je huidige abonnement. Je kunt het model kiezen in de instellingen; het prefix geeft aan welke agent antwoordt:

In de instellingen vind je de lijst met geïnstalleerde agents. Voor details over hoe elke agent wordt uitgevoerd en wat deze kan zien, kun je de gids raadplegen.

Snelstart

Installeer de software met de volgende commando's:

git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor
~/src/penmentor/bin/penmentor --selftest

Systeemvereisten:

• Linux op X11 (werkt het beste met i3).
• Een ingelogde agent (claude, codex of agy).
• De volgende tools: rofi, slop, xdotool en PyQt6.

Koppel bin/penmentor aan een sneltoets (zie voorbeeld). Voor meer informatie over de setup, toetsen en de werking kun je de gids raadplegen.

Licentie

MIT