컴패니언-캡처: Claude Code의 일시적인 말풍선을 저장하는 도구

companion-capture의 기능

터미널에서 Claude Code를 사용해 본 적이 있다면, 작업 중에 말풍선과 함께 나타나는 동반 캐릭터를 본 적이 있을 겁니다. 이 메시지는 일시적입니다—TUI가 다시 그려지면 사라집니다. 일부는 코드에 대한 유용한 관찰, 버그에 대한 경고, 또는 재미있는 코멘트를 포함하고 있습니다. companion-capture는 터미널 출력을 감시하고, 그 말풍선 메시지를 추출하여 마크다운 파일(그리고 선택적으로 검색을 위한 SQLite)에 저장합니다.

작동 방식

• 셸 래퍼가 script -q -F를 통해 Claude Code를 실행하여 원시 터미널 출력을 캡처합니다
• Python 파서가 VT100 화면 버퍼(ANSI 제거가 아닌—실제 커서 위치 추적)를 실행하여 텍스트가 실제로 렌더링되는 위치를 파악합니다
• 메시지는 기록되기 전에 두 번 연속 스캔이 필요하므로, 반쯤 렌더링된 쓰레기를 얻지 않습니다
• PostToolUse 훅이 새 캡처를 세션 중간에 Claude에게 다시 제공하여, 동반 캐릭터가 말한 내용을 실제로 볼 수 있게 합니다

기능

• 런타임 종속성 없음(표준 라이브러리 Python만 사용)
• 캡처 전체에 대한 전체 텍스트 검색(companion-capture search "auth bug")
• 개인정보 보호 제어—패턴 제외, 프로젝트 차단 목록, 소급 수정
• 최근 캡처를 Claude에게 자동으로 다시 제공하는 선택적 상황별 회상
• 전체 설정 상태 점검을 위한 companion-capture doctor
• 400개 이상의 pytest 케이스

개발자가 사용하며 발견한 점

동반 캐릭터는 실제로 문제를 잡아냅니다. 테스트 커버리지가 없는 마이그레이션 스크립트에 플래그를 달았습니다. 다중 세션 설정에서 경쟁 조건을 발견했습니다. 대부분의 경우 분위기와 반응이지만, 몇 세션마다 정말로 읽을 가치가 있는 내용을 떨어뜨립니다.

현재 제한 사항

현재는 MacOS + Claude Code만 지원합니다. 외부 종속성 없음, MIT 라이선스.

GitHub: github.com/jaywadhwa/companion-capture