- Nietzschian Debugger는 버그를 고쳐주는 대신 가정과 증거, 추론을 되묻고 개발자가 직접 원인을 찾도록 이끄는 CLI 도구임
- 모든 응답을 질문으로 구성하며 수정 방법은 알려주지 않음. AI 답변을 복사하는 지름길보다 직접 고민하는 과정을 통해 디버깅 역량을 기르는 것이 목표임
- 질문 강도는 친절한 안내형 socrates, 직설적인 기본 모드 nietzsche, 약한 추론을 거세게 파고드는 zarathustra 중 선택할 수 있음
- 실제 코드 파일 읽기, 세션 간 디버깅 역량 추적, 로컬 대화 기록을 지원하며 긴 대화에서는 이전 내용을 요약해 문맥을 관리함
- Anthropic API 키를 직접 제공해야 하며, 현재 소스는 Python 3.10 이상에서 동작함. 별도로 배포된 npm v0.1.0은 Node.js 20 이상이 필요함
- Nietzschian Debugger는 버그 설명을 입력받아 상황에 대한 가정을 의심하고, 회피하던 증거를 확인하며, 허술한 추론을 검토하도록 질문함
- 수정 방법을 직접 알려주지 않는 것이 핵심 원칙이며, 도구가 아니라 개발자 본인이 깨닫는 순간을 목표로 함
- AI 답변의 복사와 배포를 반복하는 방식에 반대하며, 빠르지만 피상적인 해결과 의존성 대신 스스로 사고하는 능력과 지속적인 학습을 지향함
- 대상은 복사 대신 배우려는 주니어 개발자, 실력을 키웠던 고민의 과정을 다시 원하는 시니어 개발자, 팀의 사고력을 중시하는 엔지니어링 관리자, 디버깅 직관을 기르는 부트캠프 수강생, 자립적인 개발을 중시하는 사람임
- 질문 강도를 개발자의 경험과 원하는 대화 방식에 맞춰 선택할 수 있음
- socrates: 따뜻하고 단계적으로 안내하는 질문으로, 주니어와 기초 학습에 적합함
- nietzsche: 직설적이고 대립적이며 세세하게 이끌어주지 않는 기본 모드로, 일상적인 디버깅을 겨냥함
- zarathustra: 약한 추론을 가차 없이 공격하는 방식으로, 강한 도전을 원하는 시니어를 겨냥함
- 예시 세션에서는 일부 사용자의 로그인 요청에만 403이 발생하는 상황을 네 번의 질문으로 좁혀감
- 실패하는 사용자와 성공하는 사용자의 차이를 묻고, 무작위라는 추측 대신 서버 로그를 확인하도록 유도함
- 만료된 JWT 토큰을 확인한 뒤 최근 인증 시스템 변경을 되짚어, 토큰 TTL 변경 후 기존 세션을 무효화하지 않은 원인을 찾아냄
- 종료 후 가정 점검, 증거 수집, 근본 원인 발견 속도를 시각적 막대로 보여줌
- 원인을 찾으면 solved 또는 found it 으로 세션을 끝낼 수 있음
- I give up은 마지막 도움 질문 하나를 받은 뒤 종료함
- exit 또는 quit은 즉시 중단하며, Ctrl+C와 Ctrl+D로 강제 종료할 수 있음
- 파일 경로를 참조하면 일반적인 예제가 아니라 사용자의 실제 코드를 읽음
- 상황에 맞는 철학적 문구를 활용함. 회피할 때는 Nietzsche, 압도당했을 때는 Seneca, 전략이 필요할 때는 Sun Tzu를 연결함
- Growth Score는 여러 세션에 걸친 디버깅 역량을 시각적 막대 차트로 추적함
- 모든 세션은 .nietzschian/sessions/ 에 로컬 저장되며, 변화 추적에 활용됨
- 슬라이딩 문맥 관리로 오래된 대화 차례를 자동 요약해 긴 세션을 이어감
- 개인 Anthropic API 키를 사용하는 BYOK 방식이며, ANTHROPIC_API_KEY 환경 변수로 키를 설정함
-
배포판과 현재 소스의 실행 환경이 다름
- npm에 배포된 v0.1.0은 Node.js 20 이상이 필요함
- 현재 소스는 Python 3.10 이상이 필요함
- Anthropic SDK를 통한 Claude API를 사용하며, CLI는 Click, 터미널 UI는 Rich로 구성함
- 테스트에는 pytest를 사용하며, 개발 안내에는 테스트 121개가 명시되어 있음
- MIT 라이선스로 제공됨