memwhale

MemoryWhale은 개발자와 코딩 에이전트를 위한 지속적이고 로컬적인 디버깅 메모리 계층입니다. 디버깅 중 실제로 일어나는 일—명령, 출력, 실패, 그리고 효과가 있었던 수정—을 포착하여 이 증거를 로컬 SQLite 데이터베이스에 저장합니다. 이를 통해 개발자와 그들의 AI 코딩 에이전트는 터미널 세션, SSH 연결, 또는 에이전트 세션이 종료된 후에도 과거 해결책을 검색할 수 있습니다. 이 도구는 로컬 우선으로 설계되었습니다: 계정, 호스팅 서비스, 토큰당 메모리 과금이 필요 없으며, 아무것도 업로드되지 않습니다. Model Context Protocol(MCP)을 통해 19개의 코딩 에이전트와 통합되어, 서로 다른 도구 간 메모리 접근을 위한 공통 접점을 제공합니다. 주요 기능은 다음과 같습니다: - **포착**: `mw global on` 또는 `mw-run`을 통해 셸 명령을 기록하고, `mw remember`로 명시적인 교훈을 저장할 수 있습니다. 장시간 작업을 위한 충돌 방지 라이브 세션 모드(`mw --live`)도 사용할 수 있습니다. - **검색**: `mw search`로 과거 실패와 수정을 검색하거나, `mw context --last-error`로 에이전트를 위한 간결한 컨텍스트를 생성합니다. - **인터페이스**: CLI, 대화형 터미널 UI(`mw tui`), 로컬 웹 대시보드(`mw-serve`), 데스크톱 앱을 제공합니다. MCP 접근은 stdio(`mw-mcp`) 또는 HTTP를 통해 가능합니다. - **에이전트 통합**: `mw integrate`는 Claude Code, Rho 같은 클라이언트를 위해 MCP 접근, 포착 훅, 메모리 사용 가이드를 설정합니다. `mw doctor`가 설정을 점검합니다. - **출처**: 에이전트 신원(예: `claude`, `rho`)을 소스 유형과 별도로 저장하여 메모리 이력을 투명하게 유지합니다. - **Git 인식**: 정규 저장소 ID가 연결된 워크트리를 그룹화하고, 탐색은 로컬 Git 메타데이터를 읽습니다. - **GitHub 컨텍스트**: `mw github context <pr>`은 기존 `gh` 로그인을 통해 PR 메타데이터, 검사, 리뷰를 가져오며, 백그라운드 동기화는 하지 않습니다. MemoryWhale은 자율 에이전트나 범용 메모리 시스템이 아니라 디버깅 메모리 계층으로 자리매김합니다. 빌드, 의존성, Git, 환경, 배포를 디버깅하는 개발자와 여러 머신에서 작업하거나 코딩 에이전트와 함께 작업하는 사람들에게 특히 유용합니다. 설치는 Linux와 macOS용 사전 빌드 바이너리, Cargo(`cargo install memorywhale-cli`), 또는 Homebrew를 통해 가능합니다. 이 프로젝트는 MIT 라이선스이며 문서, 통합 가이드, 기여 경로를 포함합니다. LongMemEval 벤치마크는 강력한 검색 성능을 보여주며, 통제된 평가는 메모리가 활성화된 에이전트 문제 해결의 상당한 개선을 입증합니다.