저는 하루 중 많은 시간을 Claude Code 안에서 보냅니다. 그래서 이를 활용한 작은 사이드 프로젝트를 만들었습니다: 바로 코딩 세션에서 키우는 가상 반려동물 모음인 Nomlings입니다. 작은 3D 장치가 터미널 옆에 떠 있습니다. 화면 속 8비트 생명체는 "tokivore(토큰 먹보)"입니다. 이 친구는 세션에서 소모되는 토큰을 먹고, 작업이 완료되면 축하하며, 도구(tools)에서 에러가 나면 투덜거리고, 실제로 결과물을 배포(ship)함에 따라 진화합니다. 심지어 당신의 음악에 맞춰 춤을 추기도 합니다.

이유: 저는 Claude Code가 작동하는 것을 몇 시간 동안 지켜보곤 하는데, 보이지 않는 요소들(토큰 소모, 도구 에러, 작업 완료)을 시각화하고 조금 더 재미있게 만들어줄 환경적인(ambient) 무언가를 원했습니다.

구현 방법: 핵심은 두 가지 데이터 소스에 의해 구동되는 Rust 상태 머신(state machine)입니다. 첫 번째는 ~/.claude/settings.json에 설치된 공식 Claude Code 훅(hooks) (SessionStart, PostToolUse, Stop 등)이고, 두 번째는 토큰 수 계산을 위한 ~/.claude/projects/*.jsonl의 세션 트랜스크립트(transcripts)입니다. 따라서 별도의 래퍼(wrapper), tmux, 또는 API 키 프록시(proxying)가 필요하지 않습니다. 이 데이터는 Three.js로 렌더링된 장치와 64px CanvasTexture 위에 그려진 8비트 반려동물이 포함된, 항상 위에 떠 있는(always-on-top) 투명한 Tauri v2 위젯으로 전달됩니다. 훅(Hooks)과 트랜스크립트를 사용하면 API 레이어에 손을 대지 않고도 세션의 놀라울 정도로 완전한 모습을 파악할 수 있습니다.

개인정보 보호: 모든 것은 로컬(locally)에서 실행됩니다. 훅(Hooks)은 localhost 서버로 게시되며, 트랜스크립트 파싱은 사용자의 컴퓨터에서 이루어지므로 PC 외부로 나가는 데이터는 아무것도 없습니다.

다운로드: https://nomlings.cc
저장소(Repositories): https://github.com/Nomlings/ submitted by /u/franwbu [link] [comments]