De Nietzschian Debugger is een tool die zich afzet tegen de trend van AI-gestuurde copy-paste oplossingen. In plaats van direct een bug op te lossen, hanteert de tool een filosofische benadering waarbij de ontwikkelaar via scherpe vragen wordt geleid naar het 'aha-moment'.
Kernpunten:
- Filosofie: Het doel is om ontwikkelaars sterker en zelfredzamer te maken door hen te dwingen aannames te toetsen en bewijs te verzamelen.
- Intensiteitsniveaus: Gebruikers kunnen kiezen uit drie modi: Socrates (ondersteunend), Nietzsche (direct/confronterend) en Zarathustra (brutaal/adversarieel).
- Functionaliteiten: De tool kan lokale code bestanden lezen, houdt een sessiegeschiedenis bij en biedt een 'Growth Score' om de voortgang in debugging-vaardigheden te meten.
- Technische stack: Gebouwd met Python en Node.js, gebruikmakend van de Anthropic API (Claude).
De tool is beschikbaar via npm en GitHub en is bedoeld voor iedereen van junior tot senior die zijn intuïtie voor debugging wil verbeteren.
Nietzschian Debugger
De Nietzschian Debugger is de anti-AI. Waar elk ander hulpmiddel je antwoorden geeft, confronteert de Nietzschian Debugger je met vragen.
Wanneer je een bug invoert, lost de tool deze niet voor je op. In plaats daarvan doet hij het volgende:
- Hij stelt je aannames over wat er gebeurt ter discussie.
- Hij dwingt je om het bewijs onder ogen te zien dat je probeert te negeren.
- Hij breekt je zwakke redeneringen af tot alleen de waarheid overblijft.
- Hij leidt je naar het "aha-moment" — jouw moment, niet dat van de AI.
Waarom?
AI maakt ontwikkelaars zwakker. Het is een cyclus van kopiëren en plakken vanuit ChatGPT, implementeren en herhalen. Hierdoor begrijpt niemand zijn eigen code meer. De Nietzschian Debugger smeedt sterkere ontwikkelaars via strijd, niet via shortcuts.
"Wie een 'waarom' heeft om te debuggen, kan bijna elk 'hoe' verdragen."
---
Installatie
Gepubliceerde release (npm, v0.1.0)
npx nietzschian-debugger
Huidige broncode (Python 3.10+)
pip install git+https://github.com/DilawarShafiq/nietzschian-debugger.git
nietzschian debug "jouw bug"
Vereisten:
- Node.js >= 20 voor de npm-release, of Python >= 3.10 voor de broncode.
- Een Anthropic API-sleutel (BYOK — bring your own key).
Configuratie
Stel je Anthropic API-sleutel in:
Linux / macOS
export ANTHROPIC_API_KEY="sk-ant-..."
Windows (PowerShell)
$env:ANTHROPIC_API_KEY = "sk-ant-..."
Windows (CMD)
set ANTHROPIC_API_KEY=sk-ant-...
---
Snelstart
Start een debug-sessie (standaard: nietzsche intensiteit)
nietzschian debug "Mijn API geeft een 500-fout, maar alleen op dinsdagen"
Gentle mode — voor wanneer je begeleiding nodig hebt, geen straf
nietzschian debug --intensity socrates "Mijn login-endpoint faalt willekeurig"
Maximale intensiteit — voor seniors die echt uitdaging zoeken
nietzschian debug --intensity zarathustra "Geheugenlek in productie"
Richten op specifieke code
nietzschian debug "Auth faalt in ./src/middleware/auth.ts"
De drie intensiteitsniveaus
| Niveau | Stijl | Beste voor |
|---|
| socrates | Warm, begeleidend, ondersteunende vragen | Juniors, het leren van basisprincipes |
| nietzsche | Direct, confronterend, geen handje vasthouden | Dagelijks debuggen (standaard) |
| zarathustra | Bruut, adversarieel, vijandig tegenover zwakke redeneringen | Seniors die echt door het vuur willen gaan |
---
Hoe een sessie eruitziet
Nietzschian Debugger v0.1.0 — intensiteit: nietzsche
Jij: Mijn login-endpoint geeft een 403-fout voor sommige gebruikers. Nietzschian: Je zegt "sommige gebruikers." Dat is vaag. Wat onderscheidt degenen die falen van degenen die dat niet doen? Jij: Ik weet het niet zeker, het lijkt willekeurig. Nietzschian: "Willekeurig" is het woord dat we gebruiken wanneer we niet hard genoeg hebben gezocht. Wat zeggen de serverlogs over de 403-responses? Ga kijken. Ik wacht wel. Jij: Even kijken... oh, ze hebben allemaal verlopen JWT-tokens. Nietzschian: Nu komen we ergens. Waarom zouden sommige gebruikers verlopen tokens hebben terwijl anderen dat niet hebben? Wat is er onlangs veranderd in je auth-systeem? Jij: ... oh. We hebben vorige week de token TTL aangepast en de bestaande sessies niet ongeldig gemaakt. Nietzschian: Daar is het. Je had niet nodig dat ik het je vertelde — je moest gedwongen worden om te kijken.
Sessie voltooid — 4 vragen tot de kernoorzaak (Opgelost)
Jouw Debugging Profiel:
- Assumption-checking: ██████████ (sterk)
- Evidence-gathering: ██████░░░░ (matig)
- Root cause speed: ████████░░ (sterk)
"De mens is iets dat overwonnen moet worden." — Friedrich Nietzsche
---
Sessiecommando's
| Commando | Effect |
|---|
solved of found it | Beëindig sessie — je hebt de kernoorzaak gevonden |
I give up | Ontvang één reddingsvraag, daarna afsluiten |
exit of quit | Sessie onmiddellijk verlaten |
Ctrl+C / Ctrl+D | Geforceerd afsluiten |
---
Kenmerken
- Geeft nooit antwoorden — Elke reactie is een vraag. De tool zal NOOIT de oplossing vertellen.
- Echt code-lezen — Verwijs naar een bestandspad en de tool leest JOUW werkelijke code, geen generieke voorbeelden.
- Contextuele filosofie — Nietzsche wanneer je ontwijkt, Seneca wanneer je overweldigd bent, Sun Tzu wanneer je strategie nodig hebt.
- Growth Score — Volg je debugging-vaardigheden over verschillende sessies met visuele staafdiagrammen.
- Sessiegeschiedenis — Alle sessies worden lokaal opgeslagen in
.nietzschian/sessions/ voor trendanalyse.
- Sliding Context — Lange sessies crashen niet; oudere beurten worden transparant samengevat.
De Filosofie
| Traditionele AI | Nietzschian Debugger |
|---|
| "Hier is de oplossing" | "Wat heb je al geprobeerd?" |
| Maakt je afhankelijk | Maakt je gevaarlijk (bekwaam) |
| Je leert niets | Je leert alles |
| Snel maar oppervlakkig | Pijnlijk maar permanent |
| AI wordt slimmer | JIJ wordt slimmer |
Voor wie is dit bedoeld?
- Junior ontwikkelaars die echt willen leren in plaats van alleen copy-pasten.
- Senior ontwikkelaars die de strijd missen die hen goed heeft gemaakt.
- Engineering managers die willen dat hun team nadenkt in plaats van alleen prompts schrijft.
- Bootcamp-studenten die echte debugging-intuïtie willen opbouwen.
- Iedereen die gelooft dat de beste ontwikkelaar een zelfredzame ontwikkelaar is.
---
Ontwikkeling
Klonen en installeren
git clone https://github.com/DilawarShafiq/nietzschian-debugger.git
cd nietzschian-debugger
pip install -e ".[dev]"
Tests draaien (121 tests)
pytest
CLI lokaal uitvoeren
nietzschian debug "test probleem"
Tech Stack
- Python >= 3.10
- Claude API via de Anthropic SDK
- Click voor de CLI, Rich voor de terminal UI
- pytest voor testen
Licentie: MIT
Nietzschian Debugger
De Nietzschian Debugger is de anti-AI. Waar elk ander hulpmiddel je antwoorden geeft, confronteert de Nietzschian Debugger je met vragen.
Wanneer je een bug invoert, lost de tool deze niet voor je op. In plaats daarvan doet hij het volgende:
- Hij stelt je aannames over wat er gebeurt ter discussie.
- Hij dwingt je om het bewijs onder ogen te zien dat je probeert te negeren.
- Hij breekt je zwakke redeneringen af tot alleen de waarheid overblijft.
- Hij leidt je naar het "aha-moment" — jouw moment, niet dat van de AI.
Waarom?
AI maakt ontwikkelaars zwakker. Het is een cyclus van kopiëren en plakken vanuit ChatGPT, implementeren en herhalen. Hierdoor begrijpt niemand zijn eigen code meer. De Nietzschian Debugger smeedt sterkere ontwikkelaars via strijd, niet via shortcuts.
"Wie een 'waarom' heeft om te debuggen, kan bijna elk 'hoe' verdragen."
---
Installatie
Gepubliceerde release (npm, v0.1.0)
npx nietzschian-debugger
Huidige broncode (Python 3.10+)
pip install git+https://github.com/DilawarShafiq/nietzschian-debugger.git
nietzschian debug "jouw bug"
Vereisten:
- Node.js >= 20 voor de npm-release, of Python >= 3.10 voor de broncode.
- Een Anthropic API-sleutel (BYOK — bring your own key).
Configuratie
Stel je Anthropic API-sleutel in:
Linux / macOS
export ANTHROPIC_API_KEY="sk-ant-..."
Windows (PowerShell)
$env:ANTHROPIC_API_KEY = "sk-ant-..."
Windows (CMD)
set ANTHROPIC_API_KEY=sk-ant-...
---
Snelstart
Start een debug-sessie (standaard: nietzsche intensiteit)
nietzschian debug "Mijn API geeft een 500-fout, maar alleen op dinsdagen"
Gentle mode — voor wanneer je begeleiding nodig hebt, geen straf
nietzschian debug --intensity socrates "Mijn login-endpoint faalt willekeurig"
Maximale intensiteit — voor seniors die echt uitdaging zoeken
nietzschian debug --intensity zarathustra "Geheugenlek in productie"
Richten op specifieke code
nietzschian debug "Auth faalt in ./src/middleware/auth.ts"
De drie intensiteitsniveaus
| Niveau | Stijl | Beste voor |
|---|
| socrates | Warm, begeleidend, ondersteunende vragen | Juniors, het leren van basisprincipes |
| nietzsche | Direct, confronterend, geen handje vasthouden | Dagelijks debuggen (standaard) |
| zarathustra | Bruut, adversarieel, vijandig tegenover zwakke redeneringen | Seniors die echt door het vuur willen gaan |
---
Hoe een sessie eruitziet
Nietzschian Debugger v0.1.0 — intensiteit: nietzsche
Jij: Mijn login-endpoint geeft een 403-fout voor sommige gebruikers. Nietzschian: Je zegt "sommige gebruikers." Dat is vaag. Wat onderscheidt degenen die falen van degenen die dat niet doen? Jij: Ik weet het niet zeker, het lijkt willekeurig. Nietzschian: "Willekeurig" is het woord dat we gebruiken wanneer we niet hard genoeg hebben gezocht. Wat zeggen de serverlogs over de 403-responses? Ga kijken. Ik wacht wel. Jij: Even kijken... oh, ze hebben allemaal verlopen JWT-tokens. Nietzschian: Nu komen we ergens. Waarom zouden sommige gebruikers verlopen tokens hebben terwijl anderen dat niet hebben? Wat is er onlangs veranderd in je auth-systeem? Jij: ... oh. We hebben vorige week de token TTL aangepast en de bestaande sessies niet ongeldig gemaakt. Nietzschian: Daar is het. Je had niet nodig dat ik het je vertelde — je moest gedwongen worden om te kijken.
Sessie voltooid — 4 vragen tot de kernoorzaak (Opgelost)
Jouw Debugging Profiel:
- Assumption-checking: ██████████ (sterk)
- Evidence-gathering: ██████░░░░ (matig)
- Root cause speed: ████████░░ (sterk)
"De mens is iets dat overwonnen moet worden." — Friedrich Nietzsche
---
Sessiecommando's
| Commando | Effect |
|---|
solved of found it | Beëindig sessie — je hebt de kernoorzaak gevonden |
I give up | Ontvang één reddingsvraag, daarna afsluiten |
exit of quit | Sessie onmiddellijk verlaten |
Ctrl+C / Ctrl+D | Geforceerd afsluiten |
---
Kenmerken
- Geeft nooit antwoorden — Elke reactie is een vraag. De tool zal NOOIT de oplossing vertellen.
- Echt code-lezen — Verwijs naar een bestandspad en de tool leest JOUW werkelijke code, geen generieke voorbeelden.
- Contextuele filosofie — Nietzsche wanneer je ontwijkt, Seneca wanneer je overweldigd bent, Sun Tzu wanneer je strategie nodig hebt.
- Growth Score — Volg je debugging-vaardigheden over verschillende sessies met visuele staafdiagrammen.
- Sessiegeschiedenis — Alle sessies worden lokaal opgeslagen in
.nietzschian/sessions/ voor trendanalyse.
- Sliding Context — Lange sessies crashen niet; oudere beurten worden transparant samengevat.
De Filosofie
| Traditionele AI | Nietzschian Debugger |
|---|
| "Hier is de oplossing" | "Wat heb je al geprobeerd?" |
| Maakt je afhankelijk | Maakt je gevaarlijk (bekwaam) |
| Je leert niets | Je leert alles |
| Snel maar oppervlakkig | Pijnlijk maar permanent |
| AI wordt slimmer | JIJ wordt slimmer |
Voor wie is dit bedoeld?
- Junior ontwikkelaars die echt willen leren in plaats van alleen copy-pasten.
- Senior ontwikkelaars die de strijd missen die hen goed heeft gemaakt.
- Engineering managers die willen dat hun team nadenkt in plaats van alleen prompts schrijft.
- Bootcamp-studenten die echte debugging-intuïtie willen opbouwen.
- Iedereen die gelooft dat de beste ontwikkelaar een zelfredzame ontwikkelaar is.
---
Ontwikkeling
Klonen en installeren
git clone https://github.com/DilawarShafiq/nietzschian-debugger.git
cd nietzschian-debugger
pip install -e ".[dev]"
Tests draaien (121 tests)
pytest
CLI lokaal uitvoeren
nietzschian debug "test probleem"
Tech Stack
- Python >= 3.10
- Claude API via de Anthropic SDK
- Click voor de CLI, Rich voor de terminal UI
- pytest voor testen
Licentie: MIT
Groetjes,