oleksiijko/pmb

어떤 프로젝트인가요?

핵심 기능

• 01결정 사항, 교훈, 사실, 프로젝트 구조를 로컬 SQLite 파일에 저장합니다.
• 02MCP를 통해 Claude Code, Cursor, Codex, Windsurf, Zed, VS Code와 연결합니다.
• 03BM25, 벡터 검색, 엔티티 그래프, 선택적 재순위화를 결합한 하이브리드 검색을 제공합니다.
• 04지원되는 에이전트에서 모델이 응답하기 전에 관련 메모리를 주입하는 라이프사이클 훅을 제공합니다.
• 05프로젝트 코드, PDF, Markdown, ChatGPT 내보내기 파일을 인덱싱합니다.
• 06메모리를 탐색할 수 있는 로컬 대시보드와 검증 및 복원이 가능한 스냅샷을 제공합니다.

활용 사례

• 코딩 세션이 바뀌어도 아키텍처 결정과 프로젝트 제약 조건을 계속 참조할 수 있도록 합니다.
• 클라우드 서비스로 데이터를 보내지 않고 Claude Code나 Cursor에 코드베이스의 지속적인 맥락을 제공합니다.
• 터미널에서 개인 메모, PDF, 과거 에이전트 대화를 검색합니다.

빠른 시작

1. 1

   PyPI에서 패키지를 설치합니다

   pip install pmb-ai
2. 2

   감지된 AI 에이전트에 PMB를 연결합니다

   pmb setup
3. 3

   첫 검색 속도를 높이기 위해 임베딩 모델을 미리 로드합니다

   pmb warmup
4. 4

   에이전트를 다시 시작한 다음 doctor 검사로 모든 연결이 제대로 되었는지 확인합니다

   pmb doctor

사용 전 알아둘 점

• !기본 임베더는 약 450MB이며, 처음 사용하기 전에 다운로드해야 합니다.
• !훅 및 선택 사항인 크로스 인코더 재랭킹과 같은 일부 기능은 특정 에이전트나 설정에서만 사용할 수 있습니다.

포함된 컬렉션

토픽

자주 묻는 질문

pmb은(는) 무엇인가요?

Claude Code, Cursor, Codex 같은 AI 코딩 에이전트를 위한 로컬 우선 영구 메모리. 디스크의 SQLite 파일을 MCP로 제공합니다. AI 코딩 에이전트는 세션이 바뀌면 결정 사항, 교훈, 프로젝트 맥락을 잊기 때문에 개발자는 같은 제약 조건을 계속 다시 설명해야 합니다. PMB는 이런 정보를 로컬 작업 공간에 지속되는 메모리로 저장합니다. SQLite가 단일 진실 공급원이며, 다시 생성할 수 있는 LanceDB 벡터 인덱스가 함께 저장됩니다. 에이전트는 prepare(message), recall(query) 같은 MCP 도구를 통해 메모리를 읽으며, 이 도구는 BM25, 벡터 검색, 엔티티 그래프, 선택적 재순위화를 결합합니다.

pmb은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

pmb은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

pmb은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. pmb의 마지막 커밋은 2026년 9월 23일입니다.

pmb은(는) 어디에 사용할 수 있나요?

코딩 세션이 바뀌어도 아키텍처 결정과 프로젝트 제약 조건을 계속 참조할 수 있도록 합니다. 클라우드 서비스로 데이터를 보내지 않고 Claude Code나 Cursor에 코드베이스의 지속적인 맥락을 제공합니다. 터미널에서 개인 메모, PDF, 과거 에이전트 대화를 검색합니다.

pmb는 어떻게 설치하나요?

PyPI에서 패키지를 설치합니다: pip install pmb-ai 감지된 AI 에이전트에 PMB를 연결합니다: pmb setup 첫 검색 속도를 높이기 위해 임베딩 모델을 미리 로드합니다: pmb warmup 에이전트를 다시 시작한 다음 doctor 검사로 모든 연결이 제대로 되었는지 확인합니다: pmb doctor

pmb은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/oleksiijko/pmb