{"_id":"nietzschian-debugger","_rev":"2-b1feb8d45b86cb5704537d8e7bd08417","name":"nietzschian-debugger","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"nietzschian-debugger","version":"0.1.0","keywords":["debugging","education","nietzsche","philosophy","developer-tools","ai","learning","critical-thinking","cli","socratic","anthropic","claude"],"author":{"name":"Dilawar Gopang"},"license":"MIT","_id":"nietzschian-debugger@0.1.0","maintainers":[{"name":"dilawargopang","email":"dilawar.gopang@gmail.com"}],"homepage":"https://github.com/DilawarShafiq/nietzschian-debugger#readme","bugs":{"url":"https://github.com/DilawarShafiq/nietzschian-debugger/issues"},"bin":{"nietzschian":"dist/cli.js"},"dist":{"shasum":"26e850d013ee3843cdd4681320f84194e5f161bb","tarball":"https://registry.npmjs.org/nietzschian-debugger/-/nietzschian-debugger-0.1.0.tgz","fileCount":57,"integrity":"sha512-WpCEQdfAfDjoL6NHTxP1obuN8ailMsE8yw4v6RbdxMQwzekt+3uaE7zKbZHfFBDa/WwbK9V+b+8xLR6A5udhzA==","signatures":[{"sig":"MEUCIFoBt1lzYCve2Do4BVwM6UWrttK3s7q8SHp0EvgfeqaHAiEAgZIlFL/fhW6XxL/ZFUlVobBuCBSp4+XmQ58McysrMOM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103925},"main":"dist/cli.js","type":"module","types":"./dist/cli.d.ts","engines":{"node":">=20.0.0"},"gitHead":"44d670a6a8a5cc7aa02c08b927c4b3ff4c458cd6","scripts":{"dev":"node --loader ts-node/esm src/cli.ts","lint":"eslint src/","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"dilawargopang","email":"dilawar.gopang@gmail.com"},"repository":{"url":"git+https://github.com/DilawarShafiq/nietzschian-debugger.git","type":"git"},"_npmVersion":"10.9.2","description":"The anti-AI debugger. What doesn't kill your code makes it stronger. Confrontational questioning for developers.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"commander":"^12.0.0","@anthropic-ai/sdk":"^0.78.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^2.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/nietzschian-debugger_0.1.0_1771976678115_0.08573834732397989","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Moved to Python. Install with: pip install nietzschian-debugger"}},"time":{"created":"2026-02-24T23:44:38.114Z","modified":"2026-10-27T16:31:00.051Z","0.1.0":"2026-02-24T23:44:38.257Z"},"bugs":{"url":"https://github.com/DilawarShafiq/nietzschian-debugger/issues"},"author":{"name":"Dilawar Gopang"},"license":"MIT","homepage":"https://github.com/DilawarShafiq/nietzschian-debugger#readme","keywords":["debugging","education","nietzsche","philosophy","developer-tools","ai","learning","critical-thinking","cli","socratic","anthropic","claude"],"repository":{"url":"git+https://github.com/DilawarShafiq/nietzschian-debugger.git","type":"git"},"description":"The anti-AI debugger. What doesn't kill your code makes it stronger. Confrontational questioning for developers.","maintainers":[{"name":"dilawargopang","email":"dilawar.gopang@gmail.com"}],"readme":"# Nietzschian Debugger\r\n\r\n> \"What doesn't kill your code makes it stronger.\"\r\n\r\nThe anti-AI. Every other tool gives you answers. Nietzschian Debugger **confronts you with questions**.\r\n\r\nYou paste your bug. It doesn't fix it. Instead, it:\r\n\r\n- Challenges your assumptions about what's happening\r\n- Forces you to confront the evidence you're avoiding\r\n- Tears apart your weak reasoning until only truth remains\r\n- Guides you to the \"aha!\" moment — YOUR moment, not the AI's\r\n\r\n## Why?\r\n\r\nAI is making developers weaker. Copy-paste from ChatGPT, ship, repeat. Nobody understands their own code anymore. **Nietzschian Debugger forges stronger developers** — through struggle, not shortcuts.\r\n\r\n> \"He who has a why to debug can bear almost any how.\"\r\n\r\n## Installation\r\n\r\n```bash\r\n# Install globally\r\nnpm install -g nietzschian-debugger\r\n\r\n# Or use directly with npx\r\nnpx nietzschian-debugger\r\n```\r\n\r\n**Requirements:**\r\n- Node.js >= 20.0.0\r\n- An Anthropic API key (BYOK — bring your own key)\r\n\r\n## Setup\r\n\r\nSet your Anthropic API key:\r\n\r\n```bash\r\n# Linux / macOS\r\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\r\n\r\n# Windows (PowerShell)\r\n$env:ANTHROPIC_API_KEY = \"sk-ant-...\"\r\n\r\n# Windows (CMD)\r\nset ANTHROPIC_API_KEY=sk-ant-...\r\n```\r\n\r\n## Quick Start\r\n\r\n```bash\r\n# Start a debugging session (default: nietzsche intensity)\r\nnietzschian debug \"My API returns 500 but only on Tuesdays\"\r\n\r\n# Gentle mode — for when you need guidance, not punishment\r\nnietzschian debug --intensity socrates \"My login endpoint fails randomly\"\r\n\r\n# Maximum intensity — for seniors who want pain\r\nnietzschian debug --intensity zarathustra \"Memory leak in production\"\r\n\r\n# Point it at specific code\r\nnietzschian debug \"Auth fails in ./src/middleware/auth.ts\"\r\n```\r\n\r\n## Three Intensity Levels\r\n\r\n| Level | Style | Best For |\r\n|-------|-------|----------|\r\n| `socrates` | Warm, guiding, scaffolded questions | Juniors, learning fundamentals |\r\n| `nietzsche` | Direct, confrontational, no hand-holding | Daily debugging (default) |\r\n| `zarathustra` | Brutal, adversarial, hostile to weak reasoning | Seniors who want real pain |\r\n\r\n## How a Session Looks\r\n\r\n```\r\n  Nietzschian Debugger v0.1.0 — intensity: nietzsche\r\n\r\nYou: My login endpoint returns 403 for some users\r\n\r\nNietzschian: You say \"some users.\" That's vague. What separates\r\n             the ones who fail from the ones who don't?\r\n\r\nYou: I'm not sure, it seems random\r\n\r\nNietzschian: \"Random\" is the word we use when we haven't looked\r\n             hard enough. What do the server logs say for the 403\r\n             responses? Go look. I'll wait.\r\n\r\nYou: Let me check... oh, they all have expired JWT tokens\r\n\r\nNietzschian: Now we're getting somewhere. Why would some users\r\n             have expired tokens while others don't? What changed\r\n             recently in your auth system?\r\n\r\nYou: ... oh. We changed the token TTL last week and didn't\r\n     invalidate existing sessions.\r\n\r\nNietzschian: There it is. You didn't need me to tell you — you\r\n             needed to be forced to look.\r\n\r\nSession Complete — 4 questions to root cause (Solved)\r\n\r\nYour Debugging Profile:\r\n┣ Assumption-checking    ██████████  strong\r\n┣ Evidence-gathering     ██████░░░░  moderate\r\n┗ Root cause speed       ████████░░  strong\r\n\r\n\"Man is something that shall be overcome.\"\r\n — Friedrich Nietzsche\r\n```\r\n\r\n## Session Commands\r\n\r\n| Command | Effect |\r\n|---------|--------|\r\n| `solved` or `found it` | End session — you found the root cause |\r\n| `I give up` | Get one lifeline question, then exit |\r\n| `exit` or `quit` | Abandon session immediately |\r\n| `Ctrl+C` / `Ctrl+D` | Force quit |\r\n\r\n## Features\r\n\r\n- **Never Gives Answers** — Every response is a question. The tool will NEVER tell you the fix.\r\n- **Real Code Reading** — Reference a file path and it reads YOUR actual code, not generic examples.\r\n- **Contextual Philosophy** — Nietzsche when you're avoiding, Seneca when overwhelmed, Sun Tzu when you need strategy.\r\n- **Growth Score** — Track your debugging skills across sessions with visual bar charts.\r\n- **Session History** — All sessions saved locally in `.nietzschian/sessions/` for trend tracking.\r\n- **Sliding Context** — Long sessions don't crash; older turns are transparently summarized.\r\n\r\n## The Philosophy\r\n\r\n| Traditional AI | Nietzschian Debugger |\r\n|---------------|---------------------|\r\n| \"Here's the fix\" | \"What have you tried?\" |\r\n| Makes you dependent | Makes you dangerous |\r\n| You learn nothing | You learn everything |\r\n| Fast but shallow | Painful but permanent |\r\n| AI gets smarter | YOU get smarter |\r\n\r\n## Who Is This For?\r\n\r\n- **Junior developers** who want to actually learn, not just copy-paste\r\n- **Senior developers** who miss the struggle that made them good\r\n- **Engineering managers** who want their team thinking, not just prompting\r\n- **Bootcamp students** building real debugging intuition\r\n- **Anyone** who believes the best developer is a self-reliant one\r\n\r\n## Development\r\n\r\n```bash\r\n# Clone and install\r\ngit clone https://github.com/your-username/nietzschian-debugger.git\r\ncd nietzschian-debugger\r\nnpm install\r\n\r\n# Build\r\nnpm run build\r\n\r\n# Run tests (121 tests)\r\nnpm test\r\n\r\n# Run CLI locally\r\nnode dist/cli.js debug \"test problem\"\r\n```\r\n\r\n## Tech Stack\r\n\r\n- TypeScript (strict mode)\r\n- Node.js >= 20\r\n- Claude API (Haiku for conversation, Sonnet for code analysis)\r\n- Commander.js for CLI\r\n- Vitest for testing\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}