raiyanyahya/recall

해결하는 문제

Recall은 Claude Code와 같은 AI 코딩 에이전트의 '콜드 스타트' 문제를 해결합니다. 새로운 세션을 시작할 때마다 이전 작업에 대한 기억이 없기 때문에, 매번 프로젝트 목표, 진행 상황, 미해결 이슈를 수동으로 다시 설명해야 하는 불편함이 생깁니다. 외부 LLM에 세션 기록을 전송하여 요약하는 데 드는 높은 토큰 비용과 개인정보 위험도 피할 수 있습니다.

작동 방식

Recall은 .recall/ 디렉터리 내에 두 개의 로컬 Markdown 파일을 유지합니다:

• history.md: 세션 동안 발생한 모든 프롬프트, 응답, 파일 변경, 명령 실행을 추가 전용으로 기록하는 로그.
• context.md: 프로젝트의 현재 상태를 요약한 파일로, 목표, 변경된 파일, 다음 단계를 포함합니다.

LLM을 사용하지 않고, TF-IDF와 TextRank 기반의 전통적인 로컬 Python 요약 알고리즘을 사용하여 기록에서 가장 중심적인 문장을 추출하고 요약을 생성합니다. 이 과정은 사용자 기계에서 완전히 로컬로 이루어지며, API 키나 네트워크 호출이 필요하지 않습니다.

대상 사용자

Claude Code나 OpenCode를 사용하면서 여러 세션에 걸쳐 지속적이고, 개인정보 보호가 보장되며, 비용 효율적인 프로젝트 메모리를 유지하고 싶은 개발자.

주요 특징

• 토큰 비용 0원: 요약은 LLM 호출이 아니라 로컬 알고리즘으로 수행되므로 사용 크레딧을 절약할 수 있습니다.
• 완전히 로컬 및 프라이버시 보장: 데이터는 기계 외부로 나가지 않습니다. 트랜스크립트와 요약은 모두 로컬에 저장되며 외부 API로 전송되지 않습니다.
• 무리 없이 사용 가능: 복잡한 설치나 로컬 모델 설정이 필요 없으며, 요약 알고리즘은 번들로 제공되고 표준 Python 라이브러리를 사용합니다.
• 에이전트에 독립적: Claude Code용으로 개발되었지만, OpenCode와 같은 다른 에이전트에도 통합 가능합니다. 메모리는 일반 Markdown 파일로 저장되기 때문입니다.